refactor: move docs/requirements.txt into pyproject.toml [docs] extra…

[jonathanhhb]

… (#180)

Brings laser-generic in line with peer projects (laser-core, laser-measles), which already expose docs deps as a [project.optional-dependencies] extra.

Changes:

• pyproject.toml: add docs extra containing the 14 mkdocs-ecosystem packages from the old requirements.txt, plus matplotlib (needed for notebook execution during docs build; not otherwise a runtime dep). Runtime deps (numpy, scipy, pandas, laser-core) are not duplicated because they're already in the main dependencies list.
• Three workflows (mkdocs-ghp.yml, mkdocs-pr.yml, release-publish.yml): replace the three-line pip install -e . + pip install mkdocs ...
  • pip install -r docs/requirements.txt block with a single pip install --index-url <IDM Artifactory> -e ".[docs]". The IDM index URL is preserved from the requirements.txt header (--index-url, not --extra-index-url, since the original file made IDM the sole source).
• docs/requirements.txt: deleted.

CHANGELOG.md still mentions docs/requirements.txt in a historical entry; that's intentional — historical changelog entries stay accurate to what shipped at the time.

[jonathanhhb]

Note on the workflow filename: On origin/main, the PR-build workflow is mkdocs-pr.yml. The mkdocs-pr-notebooks.yml version (path-gated with notebook execution) only exists on your ci/pr-notebook-execution branch and isn't yet on main. So this refactor PR updates mkdocs-pr.yml. When you merge ci/pr-notebook-execution, that PR's workflow rename will need to either come after this refactor (and pick up [docs]) or be reconciled at merge time. Worth flagging in the PR description so the order-of-operations is clear.

[Copilot]

Pull request overview

Refactors documentation dependency management by moving docs/requirements.txt into a docs optional-dependency extra in pyproject.toml, and updates CI workflows to install docs dependencies via pip install -e ".[docs]".

Changes:

• Added a docs extra under [project.optional-dependencies] containing the MkDocs ecosystem dependencies (plus matplotlib).
• Updated MkDocs build/deploy workflows to install with -e ".[docs]" instead of installing from docs/requirements.txt.
• Removed docs/requirements.txt.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
pyproject.toml	Adds docs optional-dependency extra for documentation build dependencies.
.github/workflows/release-publish.yml	Switches docs install step to use -e ".[docs]" from the IDM index.
.github/workflows/mkdocs-pr.yml	Switches docs install step to use -e ".[docs]" (but currently contains a YAML indentation bug).
.github/workflows/mkdocs-ghp.yml	Switches docs install step to use -e ".[docs]" from the IDM index.
docs/requirements.txt	Deleted; docs deps are now sourced from pyproject.toml.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.