From 04236d0b26a05418703df59421b0b9464d3e2aea Mon Sep 17 00:00:00 2001 From: Brad Barnett <127794626+bdbarnett@users.noreply.github.com> Date: Tue, 3 Nov 2026 20:05:05 -0600 Subject: [PATCH 1/2] Docs: the regenerate guide no longer links to the generator's repository --- docs/guides/regenerate-the-pages.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/guides/regenerate-the-pages.md b/docs/guides/regenerate-the-pages.md index cfc43f6..aeaee80 100644 --- a/docs/guides/regenerate-the-pages.md +++ b/docs/guides/regenerate-the-pages.md @@ -9,10 +9,10 @@ rarely. ## Set up the folders The generator finds its siblings by folder name, one level above itself. Put -the `.github` repository in a folder called `dotgithub`: +the `.github` repository in a folder called `dotgithub`, next to a clone of this +one: ```bash -git clone https://github.com/PyDevices/.github dotgithub git clone https://github.com/PyDevices/PyDevices.github.io ``` From 7b226c603f5e3bc7fea6990b9fd211b7836caea2 Mon Sep 17 00:00:00 2001 From: Brad Barnett <127794626+bdbarnett@users.noreply.github.com> Date: Tue, 3 Nov 2026 20:05:05 -0600 Subject: [PATCH 2/2] Style check: fail a pull request on the mechanical style rules --- .github/workflows/style.yml | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 .github/workflows/style.yml diff --git a/.github/workflows/style.yml b/.github/workflows/style.yml new file mode 100644 index 0000000..ab9fc31 --- /dev/null +++ b/.github/workflows/style.yml @@ -0,0 +1,16 @@ +# The mechanical house-style rules: SPDX header, no Sphinx roles in +# docstrings, no link to the .github repo from a page, no README badges or +# status banner. Pull requests check the changed files; a manual run checks +# every file. Paths that aren't ours go in .style-exclude. +name: Style + +on: + pull_request: + workflow_dispatch: + +permissions: + contents: read + +jobs: + style: + uses: PyDevices/.github/.github/workflows/reusable-style-check.yml@publishing-v20