Merge pull request #55 from dfe-analytical-services/videos-and-content

adding info on Databricks notebooks vs IDEs and content writing and u…
dfe-analytical-services · Jun 3, 2024 · 74663b8 · 74663b8
2 parents 88b0c86 + f849021
commit 74663b8
Show file tree

Hide file tree

Showing 4 changed files with 8 additions and 2 deletions.
diff --git a/ADA/ada.qmd b/ADA/ada.qmd
@@ -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. 
 
 ---
 

diff --git a/images/amend-methodology-new.png b/images/amend-methodology-new.png
diff --git a/statistics-production/ees.qmd b/statistics-production/ees.qmd
@@ -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.
 

diff --git a/writing-visualising/writing.qmd b/writing-visualising/writing.qmd
@@ -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)
-Original file line number
+Diff line change
@@ Expand Up @@
     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 @@