removed passive sentences in Principles chapter

book/principles.md

@@ -24,7 +24,7 @@ Assurance improves the average quality and includes the communication of that qu
 ```{admonition} Key strategies
 :class: admonition-strategies
 
-Government guidance is available to help you when developing analysis.
+Government guidance is available to help you when develop analysis.
 We recommend:
 
 1. The [Analysis Function reproducible analytical pipelines (RAP) strategy](https://analysisfunction.civilservice.gov.uk/policy-store/reproducible-analytical-pipelines-strategy/),
@@ -50,19 +50,18 @@ If you can't prove that you can run the same analysis, with the same data, and o
 The additional assurances of peer review, rigorous testing,
 and validity are secondary to being able to reproduce any analysis that you carry out in a proportionate amount of time.
 
-Reproducible analysis relies on a transparent production process, so that anyone can follow your steps and understand your results.
+A reproducible and transparent production process ensures that anyone can follow your steps and understand your results.
 This transparency eases reuse of your methods and results.
 Easy reproducibility helps your colleagues test and validate what you have done.
-When reproducibility is guaranteed,
-users and colleagues can focus on verifying that the implementation is correct and that the research is useful for its intended purpose.
+Guaranteeing reproducibility means that users and colleagues can focus on verifying that the implementation is correct and that the research is useful for its intended purpose.
 
 Reproducibility relies on effective documentation.
 Good documentation should show how your methodology and your implementation map to each other.
 Good documentation should allow users and other researchers to reuse and adapt your analysis.
 
 Reproducible analysis supports the requirements of the [Code of Practice for Statistics](https://www.statisticsauthority.gov.uk/code-of-practice/)
 around quality assurance and transparency (auditability).
-Wherever possible, we share the code we used to produce our outputs, along with enough data to allow for proper testing.
+We share the code we used to produce our outputs wherever possible, along with enough data to allow for proper testing.
 
 
 ## Auditable
@@ -80,31 +79,31 @@ They know who is responsible for each part of the analysis, including the assura
 They know exactly what changes have been made at any point.
 
 In a reproducible workflow, you must bring together the code and the data that you used to generate your results.
-These are ideally published alongside your reports, with a record of analytical choices made and the responsible owners of those choices.
-The transparency that this gives your work helps to increase trustworthiness.
+Ideally, you would publish these alongside your reports, with a record of analytical choices made and the responsible owners of those choices.
+This increases the trustworthiness of your work.
 More eyes examining your work can point out challenges or flaws that can help you to improve.
 You can be fully open about the decisions you made when you generated your outputs, so that other analysts can follow what you did and re-create them.
 By making your analysis reproducible, you make it easier for others to quality assure, assess and critique.
 
 
 ## Assured
 
-Good quality analysis requires good Quality Assurance (QA).
+Quality Assurance (QA) is vital for good quality analysis.
 If decisions are being made based on analysis then this analysis must be held to high standards.
 This is true for analysis carried out using any medium, including code.
 
 However, some of the analysis that we do in government doesn't bear on decisions at that level.
 We don't want to overburden analysts with QA procedures when they are not required.
 In government we advocate **proportionality** - the right quality assurance procedures for the right analysis.
-Analysis can be proportionately assured through peer review and defensive design.
+You can proportionately assure analysis through peer review and defensive design.
 
 We suggest following your department's guidance on what proportionate quality assurance looks like.
 Most departments derive their guidance from the [Aqua book](https://www.gov.uk/government/publications/the-aqua-book-guidance-on-producing-quality-analysis-for-government).
 Assurance is best demonstrated through peer review.
 Peer reviewers must be able to understand your analytical choices and be able to reproduce your conclusions.
-Dual running should be considered, particularly for high risk analysis.
+Consider dual running, particularly for high risk analysis.
 
-Guarantees of quality assurance should be published alongside any report, or be taken into consideration by decision makers.
+Publish guarantees of quality assurance alongside any report, to be taken into consideration by decision makers.
 
 
 ## Reproducible analytical pipelines