Update dependency documenteer to >=0.8.4,<0.9.0

[renovate]

This PR contains the following updates:

Package	Change	Age	Adoption	Passing	Confidence
documenteer	>=0.5.0,<0.6.0 -> >=0.8.4,<0.9.0

---

Release Notes

lsst-sqre/documenteer (documenteer)

v0.8.4

Compare Source

Fixes:

• Pin Sphinx < 7 for the guide extra (same as the pinning already being done for the pipelines and technote extras).

v0.8.3

Compare Source

Fixes:

• Pin Pydantic < 2.0.0. This is a temporary measure while we add and test compatibility with Pydantic 1 and 2.

v0.8.2

Compare Source

Fixes:

• Fixed a bug in the help subcommand for the package-docs and stack-docs commands.

v0.8.1

Compare Source

Fixes:

• Fixed a bug in the in the help subcommand for the package-docs and stack-docs commands.

v0.8.0

Compare Source

New features:

• Added a -W / --warning-is-error flag to the package-docs build and stack-docs build commands for Science Pipelines documentation builds. This flag causes Sphinx to treat warnings as errors, which is useful for CI builds.
• Also added a -n / --nitpicky flag that enables Sphinx's nitpicky mode to flag warnings when links cannot resolve.

Fixes:

• Pinned sphinx-autodoc-typehints<1.23.0 to avoid a Sphinx version conflict with sphinx-design. The former required Sphinx >= 7.

v0.7.5

Compare Source

Fixes:

• Use sphinxcontrib-jquery to ensure jQuery is available for user guide and Pipelines documentation builds. Sphinx 6 dropped jQuery from its default theme, and the new pydata-sphinx-theme v0.12 does not include it either.

v0.7.4

Compare Source

Fixes:

• Pinned Sphinx < 7 for the pipelines and technote extras since their themes are not currently compatible with Sphinx 7 and later.

v0.7.3

Compare Source

Fixes:

• Add requirements.txt and .venv/venv to the default exclude_patterns for User Guides.

v0.7.2

Compare Source

Fixes:

• Temporarily pin pydata-sphinx-theme to <0.13. The new version changed how it treats light/dark logos.

v0.7.1

Compare Source

Fixes:

• Temporarily pinning Mermaid to 9.4.0 in the User Guide configuration to workaround a change in the Mermaid CDN.

v0.7.0

Compare Source

• Documenteer provides a new Sphinx configuration profile for general Rubin user guide projects, documenteer.conf.guide.
  This configuration profile features the new pydata-sphinx-theme, with customizations based on design tokens from the Rubin Style Dictionary.
  Most metadata and Sphinx configurations can also be set through a documenteer.toml file, located alongside the standard Sphinx conf.py file.
  Install documenteer[guide] with pip to get the dependencies needed for this Sphinx configuration.

• Packaging updates:

  • Documenteer now uses pyproject.toml for its packaging.
  • The GitHub Actions workflows now use SQuaRE composite workflows for many steps.
  • The README and change log are now written in Markdown.
  • Sphinx version 5 is now included in the test matrix.

v0.6.14

Compare Source

What's Changed

• DM-35900: Update flake8 linter by @​jonathansick in https://github.com/lsst-sqre/documenteer/pull/124
• DM-35917: Back port CmdLineTask deprecation support for 0.6 release by @​jonathansick in https://github.com/lsst-sqre/documenteer/pull/128

Full Changelog: lsst-sqre/documenteer@0.6.13...0.6.14

v0.6.13

Compare Source

• Fixed the "Edit on GitHub" URL string construction in documenteer.conf.technote.

v0.6.12

Compare Source

• Add a tstn role for linking to Telescope and Site technical notes.

v0.6.11

Compare Source

Fixes:

• Fix type checking by adding stub packages.

Changes:

• Add new roles for linking to technical notes:

  • sitcomtn
  • rtn
  • pstn

• Link to technical notes, which are hosted on lsst.io, now linking directly to lsst.io rather than going through `ls.st``. This includes the sqr, dmtn, etc. roles and all the new roles mentioned above.

• Use importlib.metadata for getting the package version, rather than pkg_resources.

• Move to a src/ based package layout for consistency.

Issues:

• Temporarily disable testing the Doxygen-related Sphinx extensions.

v0.6.10

Compare Source

Fixes:

• Support sphinx-jinja 2.0.0 by using the sphinx_jinja extension name in documenteer.conf.pipelines and documenteer.conf.pipelinespkg.
  Installations that use sphinx-jinja < 2 will continue to use sphinxcontrib.jinja since the sphinx-jinja version is dynamically detected.

v0.6.9

Compare Source

Fixes:

• Add support for Sphinx 4.x by switching from sphinx.util.inspect.Signature to sphinx.util.inspect.signature for Sphinx versions 2.4 and later.
  A minimum Sphinx version 2.4 is now required.
• Updated testing matrix to test against the latest patch versions of Sphinx 2.x, 3.x, and 4.x.

v0.6.8

Compare Source

Fixes:

• Document conda-forge based installations.

• Stack documentation builds no longer include meta or build-related files in the HTML site output, such as:

  • conf.py
  • .doctrees
  • doxygen.conf
  • manifest.yaml
  • Build products from sconsUtils-based Doxygen builds, including html and xml.

v0.6.7

Compare Source

Fixes:

• The html_extras_path is no longer accidentally reset to [""] in documenteer.conf.pipelines.

• sphinx-automodapi introduces an autodoc enhancement that replace's autodoc's attr getter for type with a custom function.
  However, we're finding that this enhancement is incompatible with Pybind11 static properties that are part of the LSST Science Pipelines API.
  This release includes a new extension, documenteer.ext.autodocreset, that resets the attr getter for type to the one built into autodoc.
  This extension is used by default in documenteer.config.pipelines and documenteer.config.pipelinespkg.

v0.6.6

Compare Source

Fixes:

• Updated the documenteer.conf.pipelines (and documenteer.conf.pipelinespkg) configuration modules so that they no longer configure doxylink if the Doxygen tag file is not present.
  This change is useful for single-package documentation builds of pure-Python packages.

v0.6.5

Compare Source

Fixes:

• Updated intersphinx links for Numpy and Astropy in the Pipelines configuration (documenteer.conf.pipelines and documenteer.conf.pipelinespkg).

v0.6.4

Compare Source

Fixes:

• Fixed a syntax issue with the package's long description, and added a linting rule to prevent this issue in the future.

v0.6.2

Compare Source

Fixes:

• The build-stack-docs CLI (replaced by stack-docs build) now defaults to not generating a Doxygen configuration, or running Doxygen.
  This is consistent with the original behavior of build-stack-docs, which did not perform a Doxygen build.

• The autocppapi directive now works even if the corresponding Doxylink symbol map is unavailable.
  This feature is useful for any circumstance when a Doxygen subsite that is normally present is unavailable, such as for a single-package documentation build.

• The Doxygen subsite is only added to html_extras_path if the _doxygen/html directory is present.

• Remove the matplotlib plot extension from the legacy documenteer.sphinxconf configuration because the extension appears to be incompatible with Sphinx 3.x.

v0.6.1

Compare Source

• Fixed the "Edit on GitHub" URL string construction in documenteer.conf.technote.

v0.6.0

Compare Source

• Documenteer now works with Sphinx 2.0+.

• Documenteer's dependencies now cleanly map to each use case:

  • pip install documenteer installs only the dependencies required to use Documenteer's own Sphinx extensions.
    The dependencies are not strictly pinned (aside from Sphinx >= 2.0).

  • pip install documenteer[technote] installs the core dependencies required by Documenteer, as well as the pinned Sphinx theme and extensions used by all technote projects.

  • pip install documenteer[pipelines] installs the core dependencies required by Documenteer, as well as the Sphinx theme and extensions used by pipelines.lsst.io.
    These extensions no longer have pinned versions.

  Development and test dependencies are no longer pinned.

• Python 3.6 is no longer officially supported.
  Documenteer is tested with Python 3.7 and 3.8.

• New Sphinx configuration facilities should prevent recursion issues by more cleanly populating the Python attributes in the configuration module:

  • Technote projects now import documenteer.conf.technote in their conf.py files.
  • Stack projects now import documenteer.conf.pipelines in their conf.py files.
  • Individual Stack packages now import documenteer.conf.pipelinespkg in their conf.py files.

  The previous configuration sub-package, documenteer.sphinxconf is deprecated.
  [DM-20866]

  Overall, the configurations are compatible with these exceptions:

  • ReStructuredText source files are no longer copied into the built site for Pipelines projects (html_copy_source is False).
    This change reduces the upload site of the pipelines.lsst.io site.
  • Updated the MathJax CDN URL to point to cdnjs.

• The stack documentation build (stack-docs build) can now run a Doxygen build to generate an HTML site and tag file of the C++ API.
  The HTML site is copied into the cpp-api directory of the Sphinx site, during the Sphinx build.
  This Doxygen build replaces, and is independent of, the Doxygen build tooling in sconsUtils, lsstDoxygen, and the base package.

  ReStructuredText content can now link into the embedded Doxygen-generate site using the sphinxcontrib-doxylink extension with the new lsstcc role.
  Authors can use a new command, stack-docs listcc to find available APIs for linking.

  There is a new directive, autocppapi, part of the documenteer.ext.autocppapi extension, that helps you list and link to C++ APIs in a namespace.
  It's intended to be used equivalently to the automodapi extension.

  The built-in Doxygen build considers all Stack packages with a doc/doxygen.conf.in file.
  Documenteer creates a Doxygen configuration from the contents of each package's doxygen.conf.in file, along with built-in defaults appropriate for pipelines.lsst.io.
  For example, individual packages can add to the EXCLUDE tag.
  By default, each package's include directory is included in the Doxygen build.

  [DM-22698, DM-23094, DM-22461]

• Improved Sphinx runner (documenteer.sphinxrunner).
  [DM-26768]

• Added static type checking using mypy.
  [DM-22717, DM-26288]

• Improved packaging, testing, and development environment:

  • PEP 518-ify the build process by adding a pyproject.toml file.
  • Removed the deprecated pytest-runner plugin.
  • Moved most of the packaging configuration to setup.cfg.
  • Adopted black and isort for code formatting.
  • Migrated to tox for running tests.
  • Migrated to pre-commit for running linters and code formatters.
  • Migrated to GitHub Actions from Travis CI.

  [DM-22957 <https://jira.lsstcorp.org/browse/DM-22957>, DM-26288 <https://jira.lsstcorp.org/browse/DM-26288>]

• Documentation improvements:

  • Added a new Developer guide and Release procedure guide.
  • Added an installation page.
  • Moved the Python API reference to its own page.
  • Improved the README to list features.

• Added GitHub community health features: contributing, support, and code of conduct files.

---

Configuration

📅 Schedule: Branch creation - "before 6am on Monday" (UTC), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR has been generated by Mend Renovate. View repository job log here.

[rra]

We won't be upgrading this doc build machinery.

[renovate]

Renovate Ignore Notification

Because you closed this PR without merging, Renovate will ignore this update (>=0.8.4,<0.9.0). You will get a PR once a newer version is released. To ignore this dependency forever, add it to the ignoreDeps array of your Renovate config.

If you accidentally closed this PR, or if you changed your mind: rename this PR to get a fresh replacement PR.