fix(docs): move pages out of pages/ to restore original guide URLs (#814)

fix(docs): move pages out of pages/ to restore original URLs

The mystmd conversion nested every page under `pages/`, which added a
`pages/` segment to all guide URLs (e.g.
`/development/guides/mypy/` became `/development/pages/guides/mypy/`),
breaking existing links into the development guide.

Move the page tree back up one level so the URLs match the pre-mystmd
paths and old links work again:

- `git mv docs/pages/{guides,tutorials,principles,patterns,index.md}` to
  `docs/`
- strip `pages/` from the toc in myst.yml and from internal
  cross-reference links
- adjust the real `{include}` directives for `_partials/pyproject.md`
  (one less directory level)
- update `docs/pages/` path references in noxfile.py and
  .pre-commit-config.yaml

Assisted-by: ClaudeCode:claude-opus-4.8

Author: henryiii

.pre-commit-config.yaml

@@ -87,7 +87,7 @@ repos:
         name: Disallow improper capitalization
         language: pygrep
         entry: PyBind|Numpy|Cmake|CCache|Github|PyTest|RST|PyLint
-        exclude: (.pre-commit-config.yaml|docs/pages/guides/style\.md)$
+        exclude: (.pre-commit-config.yaml|docs/guides/style\.md)$
       - id: disallow-words
         name: Disallow certain words
         language: pygrep
@@ -101,5 +101,5 @@ repos:
         name: Cog the pages
         language: python
         entry: cog -P -r -I ./helpers
-        files: "^docs/pages/guides/(packaging_compiled|docs|tasks|gha_basic).md|^copier.yml|^docs/_partials/pyproject.md"
+        files: "^docs/guides/(packaging_compiled|docs|tasks|gha_basic).md|^copier.yml|^docs/_partials/pyproject.md"
         additional_dependencies: [cogapp, cookiecutter, tomlkit]

docs/README.md

@@ -19,7 +19,8 @@ bundle install
 bundle exec jekyll serve --livereload
 ```
 
-The pages are in markdown in `pages/`. Images and data files are in `assets/`.
+The pages are in markdown, in the `guides/`, `tutorials/`, `principles/`, and
+`patterns/` folders. Images and data files are in `assets/`.
 
 To bump versions, use nox. You can run `nox -s pc_bump` to bump the pre-commit
 versions, and `nox -s gha_bump` to bump the GitHub Actions versions.

docs/pages/guides/coverage.md docs/guides/coverage.mddocs/pages/guides/coverage.md renamed to docs/guides/coverage.md

@@ -26,7 +26,7 @@ reasons that a wheel is better than only providing an sdist:
   is going to go
 :::
 
-[on the next page]: pages/guides/gha-wheels
+[on the next page]: guides/gha-wheels
 
 ## Job setup
 

docs/pages/guides/docs.md docs/guides/docs.mddocs/pages/guides/docs.md renamed to docs/guides/docs.md

@@ -34,19 +34,19 @@ your repository with the guidelines, runnable [right in the guide][] via
 WebAssembly! All checks point to a linked badge in the guide.
 :::
 
-[tutorials]:          pages/tutorials/index
-[style]:              pages/guides/style
-[mypy]:               pages/guides/mypy
-[docs]:               pages/guides/docs
-[simple packaging]:   pages/guides/packaging-simple
-[compiled packaging]: pages/guides/packaging-compiled
-[classic packaging]:  pages/guides/packaging-classic
-[coverage]:           pages/guides/coverage
-[gha_basic]:          pages/guides/gha-basic
-[gha_pure]:           pages/guides/gha-pure
-[gha_wheels]:         pages/guides/gha-wheels
-[pytest]:             pages/guides/pytest
-[right in the guide]: pages/guides/repo-review
+[tutorials]:          tutorials/index
+[style]:              guides/style
+[mypy]:               guides/mypy
+[docs]:               guides/docs
+[simple packaging]:   guides/packaging-simple
+[compiled packaging]: guides/packaging-compiled
+[classic packaging]:  guides/packaging-classic
+[coverage]:           guides/coverage
+[gha_basic]:          guides/gha-basic
+[gha_pure]:           guides/gha-pure
+[gha_wheels]:         guides/gha-wheels
+[pytest]:             guides/pytest
+[right in the guide]: guides/repo-review
 
 [cookiecutter]:             https://cookiecutter.readthedocs.io
 [copier]:                   https://copier.readthedocs.io

docs/pages/guides/gha_basic.md docs/guides/gha_basic.mddocs/pages/guides/gha_basic.md renamed to docs/guides/gha_basic.md

@@ -70,7 +70,7 @@ everything. Try to turn on as much as possible, and increase it until you can
 run with full `strict` checking. See the [style page][] for configuration
 suggestions.
 
-[style page]: pages/guides/style
+[style page]: guides/style
 
 For a library to support typing, it has to a) add types using any of the three
 methods, and b) add a `py.typed` empty file to indicate that it's okay to look

docs/pages/guides/gha_pure.md docs/guides/gha_pure.mddocs/pages/guides/gha_pure.md renamed to docs/guides/gha_pure.md

@@ -8,7 +8,7 @@ outlined as well.
 There are several popular packaging systems. This guide covers the old
 configuration style for [Setuptools][]. Unless you really need it, you should be
 using the modern style described in [Simple
-Packaging](pages/guides/packaging-simple). The modern style is
+Packaging](guides/packaging-simple). The modern style is
 guided by Python Enhancement Proposals (PEPs), and is more stable than the
 setuptools-specific mechanisms that evolve over the years. This page is kept to
 help users with legacy code (and hopefully upgrade it).