Merge pull request #2330 from opensafely-core/update-explanation-docs

Update explanation docs

docs/explanation/index.md

@@ -1,7 +1,9 @@
-The explanation provides background knowledge for studying ehrQL.
+These explanations provide background knowledge for learning ehrQL.
 
 * [ehrQL backend tables](backend-tables.md)
 * [ehrQL output formats](output-formats.md)
 * [Using ehrQL in OpenSAFELY projects](using-ehrql-in-opensafely-projects.md)
 * [Running ehrQL](running-ehrql.md)
 * [Using the measures framework](measures.md)
+* [Selecting populations for study](selecting-populations-for-study.md)
+* [The OpenSAFELY VS Code extension](vscode-extension.md)

docs/index.md

@@ -24,7 +24,7 @@ ehrQL's documentation has four main sections:
 
 1. The [reference](reference/index.md) provides background knowledge for working with ehrQL in your project.
 
-1. The [explanation](explanation/index.md) provides background knowledge for studying ehrQL.
+1. The [explanations](explanation/index.md) provide background knowledge for learning ehrQL.
 
 ### Conventions
 

mkdocs.yml

@@ -54,8 +54,8 @@ nav:
     - Command line interface: reference/cli.md
     - Cheatsheet: reference/cheatsheet.md
     - Upgrading ehrQL from v0 to v1: reference/upgrading-ehrql-from-v0-to-v1.md
-  - Explanation:
-    - Explanation: explanation/index.md
+  - Explanations:
+    - Explanations: explanation/index.md
     - ehrQL backend tables: explanation/backend-tables.md
     - ehrQL output formats: explanation/output-formats.md
     - Using ehrQL in OpenSAFELY projects: explanation/using-ehrql-in-opensafely-projects.md