Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

adding info on Databricks notebooks vs IDEs and content writing and u… #55

Merged
merged 3 commits into from
Jun 3, 2024
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions ADA/ada.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,9 @@ The ambition is to enable access to all datasets across DfE and ESFA and retire

See the [ADA support page on how Databricks works](https://analytical-data-access.azurewebsites.net/get-support/how-databricks-works).

## Differences between IDEs and Notebooks

RStudio is an IDE (Integrated Development Environment) whereas Databricks makes use of Notebooks, where you write your code in blocks contained in individual cells. There are advantages and disadvantages to both methods, and [this NHS-R article](https://nhsdigital.github.io/rap-community-of-practice/implementing_RAP/notebooks_versus_ide_development/#what-is-this-guide-for) outlines some of the differences you might come across when switching from using IDEs to Notebooks.

---

Expand Down
Binary file added images/amend-methodology-new.png
cjrace marked this conversation as resolved.
Show resolved Hide resolved
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion statistics-production/ees.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -1268,7 +1268,7 @@ Any approved methodology changes will be published immediately so make sure you
## Methodology amendments
If you want to revise an existing methodology page you can amend the methodology which will generate a new version for you to edit.

![](../images/EES-amend-methodology.PNG)
![](../images/amend-methodology-new.PNG)

Once you're happy with your amendment it just needs to be [approved](#sign-off) in the usual way for it to be published.

Expand Down
5 changes: 4 additions & 1 deletion writing-visualising/writing.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -120,4 +120,7 @@ More detailed advice and guidance on content design best practice is available f
- [GSS best practice guidance](https://analysisfunction.civilservice.gov.uk/policy-store/writing-about-statistics-2/)
- [How to get readability scores in Microsoft Word](https://support.office.com/en-gb/article/test-your-document-s-readability-85b4969e-e80a-4777-8dd3-f7fc3c8b3fd2)
- Similarly, the [Hemingway app](http://www.hemingwayapp.com/) is an online tool to assess readability. Whilst we might not want to use this directly for final drafting, it is useful to highlight areas of particular complexity in our current narrative.
- As an illustrative example of work in other Departments - [DWP's Fraud & Error statistics before](https://www.gov.uk/government/statistics/fraud-and-error-in-the-benefit-system-201213-estimates) (128 page release), and [DWP's Fraud & Error statistics after](https://www.gov.uk/government/statistics/fraud-and-error-in-the-benefit-system-financial-year-2017-to-2018-estimates) their own modernisation work are worth a look.
- As an illustrative example of work in other Departments - [DWP's Fraud & Error statistics before](https://www.gov.uk/government/statistics/fraud-and-error-in-the-benefit-system-201213-estimates) (128 page release), and [DWP's Fraud & Error statistics after](https://www.gov.uk/government/statistics/fraud-and-error-in-the-benefit-system-financial-year-2017-to-2018-estimates) their own modernisation work are worth a look.
- [Content design: writing for GOV.UK](https://www.gov.uk/guidance/content-design/writing-for-gov-uk)
- [GOV.UK Technical Content Style Guide A-Z](https://www.gov.uk/guidance/style-guide/technical-content-a-to-z)
- [GOV.UK Style Guide Terms A-Z](https://www.gov.uk/guidance/style-guide/a-to-z-of-gov-uk-style)