Merge pull request #190 from pythonhealthdatascience/dev

Dev

Author: amyheather

.github/workflows/docker_quarto.yaml

@@ -1,4 +1,5 @@
 name: Publish docker on GHCR and quarto on GitHub pages
+run-name: Publish docker on GHCR and quarto on GitHub pages
 
 on:
   push:

.github/workflows/lint_alt_text.yml

@@ -1,4 +1,5 @@
 name: Check Alt Text
+run-name: Check Alt Text
 
 on:
   push:

CONTRIBUTING.md

@@ -160,6 +160,8 @@ sudo docker image rm -f desrapbookdocker
 
 ## Accessibility
 
+This site uses [W3C's Web Accessibility Initiative (WAI) Easy Checks](https://www.w3.org/WAI/test-evaluate/easy-checks/) as a lightweight accessibility framework. Please see this [GitHub issue](https://github.com/pythonhealthdatascience/des_rap_book/issues/188) for a record of which checks are currently met and any known limitations.
+
 Quarto's supported accessibility checker `axe` is not used because it is difficult to read, and it mostly flagged things that cannot be changed (i.e., Quarto defaults and built-ins). As such, other approaches are used.
 
 ### `lint_alt_text.py`

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Reproducible Healthcare Simulations in Python and R
+Copyright (c) 2026 STARS (Sharing Tools and Artefacts for Reproducible Simulations in healthcare) project team
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -78,6 +78,12 @@ You can also cite the archived version of this work on Zenodo: https://doi.org/1
 
 <br>
 
+## Accessibility
+
+This site uses [W3C's Web Accessibility Initiative (WAI) Easy Checks](https://www.w3.org/WAI/test-evaluate/easy-checks/) as a lightweight accessibility framework. Please see this [GitHub issue](https://github.com/pythonhealthdatascience/des_rap_book/issues/188) for a record of which checks are currently met and any known limitations.
+
+<br>
+
 ## Contributors
 
 If you're interested in contributing (or just viewing this website locally), check out the `CONTRIBUTING.md` file.

_quarto.yml

@@ -124,7 +124,8 @@ website:
       - text: |
           Part of the <a href="https://pythonhealthdatascience.github.io/stars/" target="_blank" rel="noopener">STARS research project</a>.<br>
           Code licence: <a href="https://opensource.org/license/mit" target="_blank" rel="noopener">MIT</a>.  
-          Text licence: <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank" rel="noopener">CC-BY-SA 4.0</a>.
+          Text licence: <a href="https://creativecommons.org/licenses/by-sa/4.0/" target="_blank" rel="noopener">CC-BY-SA 4.0</a>.<br>
+          <a href="/pages/changelog.qmd">Changelog</a>
     right:
       - text: |
           Heather, A., Monks, T., Mustafee, N., Harper, A., Alidoost, F., Challen, R., & Slater, T. (2025). DES RAP Book: Reproducible Discrete-Event Simulation in Python and R. https://github.com/pythonhealthdatascience/des_rap_book. https://doi.org/10.5281/zenodo.17094155.

dissemination.md

@@ -0,0 +1,24 @@
+# Dissemination / Advertising Plan
+
+This document outlines how this training resource is and will be shared with its target audience.
+
+## Publication and formal channels
+
+* Submit a journal publication describing the resource and its intended use, including a persistent link to the online book.
+* Embed and describe the resource within the [HDR UK Futures](https://hdruklearn.org/) training platform, so it appears alongside related training materials.
+
+## Professional and community networks
+
+* Share the resource on:
+    * NHS-OA community Slack.
+    * RSE community Slack.
+    * LinkedIn.
+    * PenARC comms.
+    * Open Research champions network / UK Reproducibility Network.
+* Write a blog post for the NHS-OA community about the resource.
+
+## Web presence and catalogues
+
+* Link the resource from the [STARS project site](https://pythonhealthdatascience.github.io/stars/).
+* Register in training resource catalogues [TESS](https://tess.elixir-europe.org/) and [Glittr](https://glittr.org/).
+* Include on the [Coding For Reproducible Research resource list](https://coding-for-reproducible-research.github.io/CfRR_Courses/resources/resources.html).

environment.yaml

@@ -6,6 +6,7 @@ dependencies:
   - flake8=7.3.0
   - itables=2.5.2
   - jupyter=1.1.1
+  - nbconvert=7.17.0
   - openssl=3.3.0
   - pandas=2.3.1
   - plotly=6.3.0

pages/changelog.qmd

@@ -0,0 +1,18 @@
+---
+pagetitle: Changelog
+---
+
+{{< include /CHANGELOG.md >}}
+
+<!--Adjust spacing before headers-->
+<style>
+  section.level2 {
+    padding-top: 0.5em;
+  }
+  h3 {
+    margin-top: 0.2em;
+  }
+  h4 {
+    margin-top: 0em;
+  }
+</style>

pages/guide/environment-full.yaml

@@ -6,6 +6,7 @@ dependencies:
   - flake8=7.3.0
   - itables=2.5.2
   - jupyter=1.1.1
+  - nbconvert-core=7.16.6
   - openssl=3.3.0
   - pandas=2.3.1
   - plotly=6.3.0