Skip to content

Commit

Permalink
Add feedback links to various tutorial pages
Browse files Browse the repository at this point in the history
  • Loading branch information
rw251 committed Jan 29, 2025
1 parent a66fdac commit e769682
Show file tree
Hide file tree
Showing 7 changed files with 31 additions and 1 deletion.
4 changes: 4 additions & 0 deletions docs/tutorial/building-a-dataset/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,11 @@ Note that it is essential that the dataset you create is given the name `dataset
Next: [Using ehrQL as part of a study](../using-ehrql-as-part-of-a-study/index.md)

!!! abstract "Feedback"
Had enough? That's not a problem, but if you could fill in this very short [feedback form][5]{:target="_blank"} we'd really appreciate it.

[1]: https://www.opencodelists.org/codelist/nhsd-primary-care-domain-refsets/prt_cod/
[2]: https://www.opencodelists.org/codelist/nhsd-primary-care-domain-refsets/mal_cod/
[3]: https://www.opencodelists.org/codelist/opensafely/ace-inhibitor-medications/
[4]: https://www.opencodelists.org/codelist/opensafely/angiotensin-ii-receptor-blockers-arbs/
[5]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
4 changes: 4 additions & 0 deletions docs/tutorial/more-complex-transformations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -307,8 +307,12 @@ We're showing all the boolean series together so that you can see why different

Next: [Building a dataset](../building-a-dataset/index.md)

!!! abstract "Feedback"
Had enough? That's not a problem, but if you could fill in this very short [feedback form][6]{:target="_blank"} we'd really appreciate it.

[1]: https://docs.opensafely.org/ehrql/reference/schemas/core/#practice_registrations
[2]: https://stackoverflow.com/questions/4172448/is-it-possible-to-break-a-long-line-to-multiple-lines-in-python
[3]: ../../how-to/codelists.md
[4]: https://www.opencodelists.org/codelist/nhsd-primary-care-domain-refsets/dm_cod/
[5]: https://www.opencodelists.org/codelist/nhsd-primary-care-domain-refsets/dmres_cod/
[6]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
5 changes: 5 additions & 0 deletions docs/tutorial/quiz/index.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
!!! abstract inline end "Feedback"
You finished the tutorial - well done!. Either now, or after you've tried the quiz, we'd love it if you could fill in this very short [feedback form][1]{:target="_blank"}.

To test your understanding of ehrQL, the tutorial repository contains a file (called `quiz.py`) with some gaps for you to fill in.

Open the file now in your Codespace.
Expand Down Expand Up @@ -67,3 +70,5 @@ The quiz takes you through categorising patients according to two other (simplif
9: Create a patient frame containing the latest HbA1c measurement for each patient.

10: Create a boolean patient series identifying patients without moderate or severe frailty in whom the last IFCC-HbA1c is 58 mmol/mol or less.

[1]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
6 changes: 5 additions & 1 deletion docs/tutorial/setting-up/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ See the "[Signing up for a new GitHub account][1]" page in the GitHub docs.

## Cloning the template repository

To start, clone the tutorial repository into your own GitHub account by clicking the following link: [https://github.com/opensafely/ehrql-tutorial/generate](https://github.com/opensafely/ehrql-tutorial/generate).
To start, clone the tutorial repository into your own GitHub account by clicking the following link: [https://github.com/opensafely/ehrql-tutorial/generate](https://github.com/opensafely/ehrql-tutorial/generate).

Leave the "Include all branches" option unchecked, and, using the _Owner_ drop-down menu, select your GitHub account as the owner.

Expand Down Expand Up @@ -57,7 +57,11 @@ If you don't see this, get in touch with the OpenSAFELY tech team via your copil

Next: [Working with data with ehrQL](../working-with-data-with-ehrql/index.md)

!!! abstract "Feedback"
Had enough? That's not a problem, but if you could fill in this very short [feedback form][5]{:target="_blank"} we'd really appreciate it.

[1]: https://docs.github.com/en/get-started/start-your-journey/creating-an-account-on-github
[2]: https://github.com/opensafely/ehrql-tutorial/
[3]: https://docs.github.com/en/codespaces/overview
[4]: https://www.bennett.ox.ac.uk/blog/2024/07/research-ready-computers-in-the-cloud/
[5]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
4 changes: 4 additions & 0 deletions docs/tutorial/simple-transformations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -110,8 +110,12 @@ The full range of language features is documented in the [ehrQL Language Referen
Next: [More complex transformations](../more-complex-transformations/index.md)

!!! abstract "Feedback"
Had enough? That's not a problem, but if you could fill in this very short [feedback form][6]{:target="_blank"} we'd really appreciate it.

[1]: ../../reference/schemas/core.md#patients.age_on
[2]: ../../reference/language.md#DatePatientSeries.sub
[3]: ../../reference/language.md#DateDifference.years
[4]: ../../reference/language.md#BoolPatientSeries.is_null
[5]: ../../reference/language.md
[6]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
5 changes: 5 additions & 0 deletions docs/tutorial/using-ehrql-as-part-of-a-study/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,5 +33,10 @@ Note: [the main OpenSAFELY tutorial][2] documents how you can describe the actio

Next: [Test your ehrQL knowledge with a quiz!](../quiz/index.md)

!!! abstract "Feedback"
Don't fancy the quiz? That's not a problem, but if you could fill in this very short [feedback form][3]{:target="_blank"} we'd really appreciate it.


[1]: https://docs.opensafely.org/opensafely-cli/#exec-interactive-development
[2]: https://docs.opensafely.org/getting-started/tutorial/run-the-project-pipeline/
[3]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview
4 changes: 4 additions & 0 deletions docs/tutorial/working-with-data-with-ehrql/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,10 @@ In the next sections we will demonstrate how to work with these objects.

Next: [Simple transformations](../simple-transformations/index.md)

!!! abstract "Feedback"
Had enough? That's not a problem, but if you could fill in this very short [feedback form][4]{:target="_blank"} we'd really appreciate it.

[1]: https://docs.opensafely.org/getting-started/tutorial/add-a-scripted-action-to-the-pipeline/
[2]: ../../how-to/dummy-data.md
[3]: ../../explanation/vscode-extension.md
[4]: https://docs.google.com/forms/d/e/1FAIpQLSeouuTXPnwShAjBllyln4tl2Q52PMG_aUhpma4odpE2MmCngg/viewform?usp=preview

0 comments on commit e769682

Please sign in to comment.