Built site for gh-pages

.nojekyll

@@ -1 +1 @@
-d0765dd8
+e677a966

README.md

@@ -0,0 +1,38 @@
+# NHSBSA Producing Quality Analysis Playbook
+
+This repository contains the framework for writing and deploying the NHSBSA Producing Quality Analysis Playbook. 
+The Playbook is used to give detailed guidance on producing quality analysis.
+
+The live version of The Playbook can be found [here](https://nhsbsa-data-analytics.github.io/nhsbsa-quality-analysis-playbook/).
+
+## Getting started
+
+The Playbook is created using [Quarto](https://quarto.org/docs/get-started/). 
+You can run the document by:
+1. Opening the repository in Rstudio or VS Code
+    - For Rstudio usage, you simply require the latest version of Rstudio. 
+    - For VS Code, you must install the Quarto extension and install the Quarto CLI. When running Quarto for the first time, you will be prompted with instructions on how to install this. **Please note this is not currently possible with the Azure Virtual Desktop (AVD)**.
+1. Opening [index.qmd](/index.qmd) in the repository root
+1. Click 'Compile' or 'Preview' respectively. 
+    - Note: for Rstudio usage, you must also load the `quality-analysis-playbook.Rproj` project to be able to compile the document. 
+
+## Folder Structure
+
+The playbook is structured into a series of sections and sub-sections. The home page first greets the users with the tabs to navigate to the four main sections. Then, once the user has clicked on a section, they are then provided with additional tabs to navigate to a page about each sub-section. The following folder structure highlights how this is setup up from a coding perspective. Each section and sub-section is populated by a `.qmd` file and supporting `.jpeg` file to provide the image for each tab.
+
+```
+NHSBSA Producing Quality Analysis Playbook
+├───guidance ............................# Folder containing all of the playbook content separated by pages
+|   ├───_metadata.yml ...................# Additional settings applied to the quarto document
+├───static ..............................# A folder containing the the BSA visual settings for the quarto document
+├───_quarto.yml .........................# A file that controls the page layout and settings for the quarto document
+├───about.qmd ...........................# An additional .qmd that populates the 'About' button within the document
+├───quality-analysis-playbook.Rproj .................# The R Project file
+├───index.qmd ...........................# The primary .qmd file, used to compile the entire document.
+├───README.md ...........................# The README file
+├───styles.css ..........................# A file containing some additional settings for the quarto document
+```
+
+## Contributing to The Playbook
+We welcome contributions from community members. 
+Please see our [contributing guide](./CONTRIBUTE.md) for information on how you can get involved!

guidance/02-analytical-cycle/index.html

@@ -330,7 +330,7 @@ <h1 class="title d-none d-lg-block">Analytical Cycle</h1>
 
 <div class="quarto-listing quarto-listing-container-grid" id="listing-listing">
 <div class="list grid quarto-listing-cols-3">
-<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="2" data-listing-word-count-sort="243">
+<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="2" data-listing-word-count-sort="243">
 <a href="../../guidance/02-analytical-cycle/pages/03-customer-engagement.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -352,7 +352,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="2" data-listing-word-count-sort="350">
+<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="2" data-listing-word-count-sort="350">
 <a href="../../guidance/02-analytical-cycle/pages/04-analysis-design.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -374,7 +374,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="2" data-listing-word-count-sort="243">
+<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="2" data-listing-word-count-sort="243">
 <a href="../../guidance/02-analytical-cycle/pages/05-conducting-the-analysis.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -396,7 +396,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="3" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="1" data-listing-word-count-sort="129">
+<div class="g-col-1" data-index="3" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="1" data-listing-word-count-sort="129">
 <a href="../../guidance/02-analytical-cycle/pages/06-delivery-and-approval.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -418,7 +418,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="4" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="2" data-listing-word-count-sort="233">
+<div class="g-col-1" data-index="4" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="2" data-listing-word-count-sort="233">
 <a href="../../guidance/02-analytical-cycle/pages/07-approval-and-distribution.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -440,7 +440,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="5" data-listing-file-modified-sort="1737358602869" data-listing-reading-time-sort="1" data-listing-word-count-sort="99">
+<div class="g-col-1" data-index="5" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="1" data-listing-word-count-sort="99">
 <a href="../../guidance/02-analytical-cycle/pages/08-review.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">

guidance/03-responsibilities/index.html

@@ -329,7 +329,7 @@ <h1 class="title d-none d-lg-block">Responsibilities</h1>
 
 <div class="quarto-listing quarto-listing-container-grid" id="listing-listing">
 <div class="list grid quarto-listing-cols-3">
-<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737358602967" data-listing-reading-time-sort="1" data-listing-word-count-sort="183">
+<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737545342338" data-listing-reading-time-sort="1" data-listing-word-count-sort="183">
 <a href="../../guidance/03-responsibilities/pages/09-commissioner-responsibilities.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -351,7 +351,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737358602967" data-listing-reading-time-sort="1" data-listing-word-count-sort="148">
+<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737545342338" data-listing-reading-time-sort="1" data-listing-word-count-sort="148">
 <a href="../../guidance/03-responsibilities/pages/10-analyst-responsibilities.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -373,7 +373,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737358602967" data-listing-reading-time-sort="1" data-listing-word-count-sort="85">
+<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737545342338" data-listing-reading-time-sort="1" data-listing-word-count-sort="85">
 <a href="../../guidance/03-responsibilities/pages/11-critical-friend.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">

index.html

@@ -5283,7 +5283,7 @@ <h1 class="title d-none d-lg-block">NHSBSA Producing Quality Analysis Playbook</
 
 <div class="quarto-listing quarto-listing-container-grid" id="listing-listing">
 <div class="list grid quarto-listing-cols-3">
-<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737358602861" data-listing-reading-time-sort="2" data-listing-word-count-sort="234">
+<div class="g-col-1" data-index="0" data-listing-file-modified-sort="1737545342231" data-listing-reading-time-sort="2" data-listing-word-count-sort="234">
 <a href="./guidance/01-principles/index.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">
@@ -5305,7 +5305,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737358602868" data-listing-reading-time-sort="1" data-listing-word-count-sort="1">
+<div class="g-col-1" data-index="1" data-listing-file-modified-sort="1737545342239" data-listing-reading-time-sort="1" data-listing-word-count-sort="1">
 <a href="./guidance/02-analytical-cycle/index.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top"><img src="guidance/02-analytical-cycle/workflow.jpg" style="height: 150px;"  class="thumbnail-image card-img"/></p>
@@ -5325,7 +5325,7 @@ <h5 class="no-anchor card-title listing-title">
 </div>
 </a>
 </div>
-<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737358602967" data-listing-reading-time-sort="1" data-listing-word-count-sort="1">
+<div class="g-col-1" data-index="2" data-listing-file-modified-sort="1737545342338" data-listing-reading-time-sort="1" data-listing-word-count-sort="1">
 <a href="./guidance/03-responsibilities/index.html" class="quarto-grid-link">
 <div class="quarto-grid-item card h-100 card-left">
 <p class="card-img-top">

search.json

@@ -84,6 +84,48 @@
       "NHSBSA Producing Quality Analysis Playbook"
     ]
   },
+  {
+    "objectID": "CONTRIBUTE.html",
+    "href": "CONTRIBUTE.html",
+    "title": "How to contribute",
+    "section": "",
+    "text": "Hi there! Thank you for considering contributing to the NHSBSA Producing Quality Analysis Playbook. The Playbook is meant to serve the D&A community, so contributions from community members themselves are super important in making this a reality!\n\n\nIf you think of something worth including, improving, or want to contribute, please raise an issue on GitHub.\n\n\n\nPlease submit new contributions via a pull request:\n\nFork or clone the repository\nIf you want to run the page on your machine, configure and install the dependencies. See the README for details.\nCreate a new branch: (e.g. git checkout -b my-branch-name)\nMake your change\nPush to your fork and submit a pull request\n\nYour pull request will then be reviewed. You may receive some feedback and suggested changes before it can be approved and your pull request merged.\n\n\n\nIf you are making visual changes, include a screenshot of what the affected element looks like, both before and after.  \nKeep your change as focussed as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.\nWrite good commit messages.\n\n\n\n\n\n\n\n\n\nThe easiest way is just to open the repo in Github Codespaces - you can then make your changes, run the website to check it, and commit those back all within a VSCode environment.\n\n\n\nIf you don’t want to use Github codespaces (or can’t because it’s blocked, or you’ve run out of credits), then you can make changes to the repo locally on your machine.\n\n\n\n\nSee the README for guidance on installing the dependencies and getting started with development.\n\n\n\n\n\n\nNavigate to the relevant subfolder within guidance (e.g. guidance/03-responsibilities/pages)\nAdd a qmd file with the following header fields: ---     title: \"This is the title of your page\"     description: \"This is a brief description of your page\"     image-alt: \"This text will show if your image can't be displayed\"     image: <name of a .jpg file stored in the same subfolder to use for the card>     ---\nAdd the content below the header using standard markdown syntax.\nA link to the page will be added as a card on the landing page. If you want to show an image on the card, add a jpeg file to the same subfolder as the content and include the name in the header fields as above.\nOnce you are happy with your changes submit a pull request!\n\n\n\n\n\nCreate the a subfolder within guidance and name it appropriately (e.g. 04-business-critical-models). Note that the sections will be ordered in the dropdown on the website according to the numbers in front of the subfolders (i.e. first 01- then 02- and so on)\nAdd an index.qmd file to the subfolder (you can use one of the existing files as an example!)\nFollow the steps above to add the new page within the section you’ve just created.\nOnce you are happy with your changes submit a pull request!\n\n\n\n\n\n\n\nContributing to Projects\nUsing Pull Requests\nGitHub Help\n\n\n\n\nThank you to the NHS England RAP Community of Practice from which this guide took heavy inspiration!"
+  },
+  {
+    "objectID": "CONTRIBUTE.html#creating-an-issue",
+    "href": "CONTRIBUTE.html#creating-an-issue",
+    "title": "How to contribute",
+    "section": "",
+    "text": "If you think of something worth including, improving, or want to contribute, please raise an issue on GitHub."
+  },
+  {
+    "objectID": "CONTRIBUTE.html#submitting-a-pull-request",
+    "href": "CONTRIBUTE.html#submitting-a-pull-request",
+    "title": "How to contribute",
+    "section": "",
+    "text": "Please submit new contributions via a pull request:\n\nFork or clone the repository\nIf you want to run the page on your machine, configure and install the dependencies. See the README for details.\nCreate a new branch: (e.g. git checkout -b my-branch-name)\nMake your change\nPush to your fork and submit a pull request\n\nYour pull request will then be reviewed. You may receive some feedback and suggested changes before it can be approved and your pull request merged.\n\n\n\nIf you are making visual changes, include a screenshot of what the affected element looks like, both before and after.  \nKeep your change as focussed as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.\nWrite good commit messages."
+  },
+  {
+    "objectID": "CONTRIBUTE.html#getting-started-with-development",
+    "href": "CONTRIBUTE.html#getting-started-with-development",
+    "title": "How to contribute",
+    "section": "",
+    "text": "The easiest way is just to open the repo in Github Codespaces - you can then make your changes, run the website to check it, and commit those back all within a VSCode environment.\n\n\n\nIf you don’t want to use Github codespaces (or can’t because it’s blocked, or you’ve run out of credits), then you can make changes to the repo locally on your machine.\n\n\n\n\nSee the README for guidance on installing the dependencies and getting started with development.\n\n\n\n\n\n\nNavigate to the relevant subfolder within guidance (e.g. guidance/03-responsibilities/pages)\nAdd a qmd file with the following header fields: ---     title: \"This is the title of your page\"     description: \"This is a brief description of your page\"     image-alt: \"This text will show if your image can't be displayed\"     image: <name of a .jpg file stored in the same subfolder to use for the card>     ---\nAdd the content below the header using standard markdown syntax.\nA link to the page will be added as a card on the landing page. If you want to show an image on the card, add a jpeg file to the same subfolder as the content and include the name in the header fields as above.\nOnce you are happy with your changes submit a pull request!\n\n\n\n\n\nCreate the a subfolder within guidance and name it appropriately (e.g. 04-business-critical-models). Note that the sections will be ordered in the dropdown on the website according to the numbers in front of the subfolders (i.e. first 01- then 02- and so on)\nAdd an index.qmd file to the subfolder (you can use one of the existing files as an example!)\nFollow the steps above to add the new page within the section you’ve just created.\nOnce you are happy with your changes submit a pull request!"
+  },
+  {
+    "objectID": "CONTRIBUTE.html#resources",
+    "href": "CONTRIBUTE.html#resources",
+    "title": "How to contribute",
+    "section": "",
+    "text": "Contributing to Projects\nUsing Pull Requests\nGitHub Help"
+  },
+  {
+    "objectID": "CONTRIBUTE.html#acknowledgements",
+    "href": "CONTRIBUTE.html#acknowledgements",
+    "title": "How to contribute",
+    "section": "",
+    "text": "Thank you to the NHS England RAP Community of Practice from which this guide took heavy inspiration!"
+  },
   {
     "objectID": "about.html",
     "href": "about.html",