Run just generate-docs

Author: evansd

docs/includes/generated_docs/language__permissions.md

@@ -0,0 +1,22 @@
+
+<h4 class="attr-heading" id="claim_permissions" data-toc-label="claim_permissions" markdown>
+  <tt><strong>claim_permissions</strong>(<em>*permissions</em>)</tt>
+</h4>
+<div markdown="block" class="indent">
+Some tables and features in ehrQL can only be accessed with specific permission set
+by the OpenSAFELY team. These restrictions are only enforced when working with real
+data, however to avoid confusion we also check them when working with dummy data.
+
+When using dummy data you can grant yourself any permission using the
+`claim_permissions()` function. For example:
+
+    from ehrql import claim_permissions
+
+    claim_permissions("some_permission", "another_permission")
+
+This can go anywhere in your dataset or measure definition file.
+
+This will allow you to develop your ehrQL code locally. But please **note that you
+will only be able to run against real data if you have had the necessary permissions
+granted by the OpenSAFELY team**.
+</div>

docs/includes/generated_docs/schemas/raw.tpp.md

@@ -475,6 +475,10 @@ Date on which the current dataset was imported.
 <p class="dimension-indicator"><code>many rows per patient</code></p>
 ## isaric
 
+!!! warning "Access to this table requires the `isaric` permission"
+
+    Helpful text goes here.
+
 ISARIC is a dataset of COVID-19-related hospital admissions,
 with coverage across the majority of hospitals across the UK,
 including much richer clinical information
@@ -1465,6 +1469,10 @@ Medical condition mentioned on the death certificate.
 
 National Waiting List Clock Stops
 
+!!! warning "Access to this table requires the `waiting_list` permission"
+
+    Helpful text goes here.
+
 The columns in this table have the same data types as the columns in [the associated
 database table][wl_clockstops_raw_1]. The three "pseudo" columns are small
 exceptions, as they are converted from binary columns to string columns.
@@ -1614,6 +1622,10 @@ exceptions, as they are converted from binary columns to string columns.
 
 National Waiting List Open Pathways
 
+!!! warning "Access to this table requires the `waiting_list` permission"
+
+    Helpful text goes here.
+
 The columns in this table have the same data types as the columns in [the associated
 database table][wl_openpathways_raw_1]. The three "pseudo" columns are small
 exceptions, as they are converted from binary columns to string columns.

docs/includes/generated_docs/schemas/tpp.md

@@ -701,6 +701,10 @@ The date of discharge from a hospital provider spell.
 
 Appointments in primary care.
 
+!!! warning "Access to this table requires the `appointments` permission"
+
+    Helpful text goes here.
+
 !!! warning
     In TPP this data comes from the "Appointment" table. This table has not yet been
     well characterised, so there are some issues around how to interpret findings
@@ -2691,6 +2695,10 @@ The date the referral request was received by the health care provider.
 
 This table contains responses to questions from the OpenPROMPT project.
 
+!!! warning "Access to this table requires the `open_prompt` permission"
+
+    Helpful text goes here.
+
 You can find out more about this table in the associated short data report. To view
 it, you will need a login for [Level 4][open_prompt_1]. The
 [workspace][open_prompt_2] shows when the code that comprises the report was run;
@@ -3348,6 +3356,10 @@ used to do so.
 <p class="dimension-indicator"><code>many rows per patient</code></p>
 ## ukrr
 
+!!! warning "Access to this table requires the `ukrr` permission"
+
+    Helpful text goes here.
+
 The UK Renal Registry (UKRR) contains data on patients under secondary renal care
 (advanced chronic kidney disease stages 4 and 5, dialysis, and kidney transplantation)
 <div markdown="block" class="definition-list-wrapper">
@@ -3525,6 +3537,10 @@ Vaccine's product name.
 
 Waiting List Minimum Data Set Clock Stops
 
+!!! warning "Access to this table requires the `waiting_list` permission"
+
+    Helpful text goes here.
+
 These data are from the patient-level [Waiting List Minimum Data Set (WLMDS)](https://www.england.nhs.uk/statistics/statistical-work-areas/rtt-waiting-times/wlmds/),
 which are reported separately from the aggregate [Referral to Treatment (RTT) data](https://www.england.nhs.uk/statistics/statistical-work-areas/rtt-waiting-times/).
 
@@ -3710,6 +3726,10 @@ The Sunday of the week that the pathway relates to
 
 Waiting List Minimum Data Set Open Pathways
 
+!!! warning "Access to this table requires the `waiting_list` permission"
+
+    Helpful text goes here.
+
 These data are from the patient-level [Waiting List Minimum Data Set (WLMDS)](https://www.england.nhs.uk/statistics/statistical-work-areas/rtt-waiting-times/wlmds/),
 which are reported separately from the aggregate [Referral to Treatment (RTT) data](https://www.england.nhs.uk/statistics/statistical-work-areas/rtt-waiting-times/).