documenteer 1.2.1__tar.gz → 1.2.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {documenteer-1.2.1 → documenteer-1.2.2}/CHANGELOG.md +27 -18
- {documenteer-1.2.1 → documenteer-1.2.2}/PKG-INFO +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/index.ipynb +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/index.md +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/index.rst +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/changelog.md +27 -18
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/jira-reference.rst +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/guide.py +1 -2
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/pipelines.py +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/jira.py +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/PKG-INFO +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/jira_test.py +1 -1
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_conf_toml.py +2 -2
- {documenteer-1.2.1 → documenteer-1.2.2}/.flake8 +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/CODE_OF_CONDUCT.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/CONTRIBUTING.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/SUPPORT.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/dependabot.yml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/workflows/ci-cron.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/workflows/ci.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.github/workflows/dependencies.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.npmrc +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.nvmrc +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.pre-commit-config.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.prettierignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.prettierrc.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.vscode/settings.json +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/.vscode/tasks.json +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/LICENSE +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/MANIFEST.in +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/changelog.d/_template.md.jinja +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/diagram.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/ipynb-technote/technote.toml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/diagram.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/md-technote/technote.toml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/diagram.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/demo/rst-technote/technote.toml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/_rst_epilog.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/documenteer.conf.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/documenteer.ext.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/documenteer.requestsutils.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/documenteer.sphinxrunner.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/documenteer.stackdocs.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/api/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/development.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/html-templates.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/release.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/theme-assets.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/dev/theme.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/documenteer.toml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/badges.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/configuration-preset.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/configuration.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/diagrams.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/extend-conf-py.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/including-notebooks.ipynb +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/markdown-primer.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/openapi.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/organization.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/overview.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/build-overview.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/configuration.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/cpp-api-linking.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/install.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/package-docs-cli.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pipelines/stack-docs-cli.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/pyproject-configuration.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/rst-epilog.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/tabsets.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/guides/toml-reference.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/autocppapi.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/autodocreset.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/docushare-reference.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/githubbibcache.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/lsst-pybtex-style.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/lssttasks.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/openapi.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/package-toctree.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/sphinx-extensions/remote-code-block.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/_templates/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/_templates/README.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/author-metadata.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/configuration.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/document-status.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/edit-locally.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/edit-on-github.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/extensions.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/how-your-technote-gets-published.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/migrate.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/docs/technotes/start-a-technote.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/licenses/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/licenses/astropy-helpers.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/licenses/sphinx-issue.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/licenses/sphinx.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/package-lock.json +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/package.json +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/postcss.config.js +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/pyproject.toml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/setup.cfg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/SourceSans3VF-Italic.ttf.woff2 +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/SourceSans3VF-Upright.ttf.woff2 +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/_hacks.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/_properties.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_article-header.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_authors.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_global-breadcrumbs.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_index.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_sidebar-section.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/components/_version-info.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/assets/rubin-technote/styles/rubin-technote.scss +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/.gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/731c8feefe13e72a8691.woff2 +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/b8bc3440ba2145e132f5.woff2 +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/favicon.ico +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rsd-assets/rubin-imagotype-color-on-black-crop.svg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rsd-assets/rubin-imagotype-color-on-white-crop.svg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-favicon-transparent-32px.png +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-favicon.svg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-pydata-theme.css +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-technote.css +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-technote.css.map +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-titlebar-imagotype-dark.svg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/rubin-titlebar-imagotype-light.svg +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/scripts/rubin-technote.js +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/assets/scripts/rubin-technote.js.map +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/cli.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/_toml.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/_utils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/pipelinespkg.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/conf/technote.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/_utils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/autocppapi.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/autodocreset.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/bibtex.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/githubbibcache.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lsstdocushare.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/configfieldlists.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/crossrefs.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/pyapisummary.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/taskutils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/topiclists.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/lssttasks/topics.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/mockcoderefs.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/openapi.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/packagetoctree.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/ext/remotecodeblock.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/packagemetadata.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/py.typed +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/requestsutils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/services/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/services/technoteauthor.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/services/technotemigration.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/sphinxrunner.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/build.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/data/cppreference-doxygen-web.tag.xml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/data/doxygen.defaults.conf +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/data/mainpage.dox +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/doxygen.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/doxygentag.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/packagecli.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/pkgdiscovery.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/rootdiscovery.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/stackdocs/stackcli.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/authordb.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/latex.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/Makefile +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/README.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/ci.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/dependabot.yml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/gitignore +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/pre-commit-config.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/requirements.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates/technote/tox.ini +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/localtemplates.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/storage/technotetoml.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/pydata/layout.html +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/.gitkeep +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/components/.gitkeep +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/components/sidebar-source.html +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/sections/.gitkeep +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/sections/header-article.html +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/templates/technote/sections/sidebar-primary.html +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/utils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer/version.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/SOURCES.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/dependency_links.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/entry_points.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/requires.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/src/documenteer.egg-info/top_level.txt +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/conftest.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/afw.doxygen.conf +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/authordb.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/doxygen.tag.zip +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/doc/_static/package_alpha/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/doc/doxygen.conf.in +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/doc/manifest.yaml +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/doc/package.alpha/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/doc/package_alpha/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/include/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_alpha/src/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/data/package_beta/doc/README.md +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/autocppapi_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/lsstdocushare_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/lssttasks/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/lssttasks/taskutils_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/mockcoderefs_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/packagetoctree_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/ext/utils_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/packagemetadata_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/roots/test-autocppapi/conf.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/roots/test-autocppapi/doxygen.tag.zip +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/roots/test-autocppapi/index.rst +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/services/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/services/technotemigration_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/storage/__init__.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/storage/authordb_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/storage/technotetoml_test.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_conf_utils.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_stackdocs_build.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_stackdocs_doxygen.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_stackdocs_doxygentag.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_stackdocs_pkgdiscovery.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tests/test_stackdocs_rootdiscovery.py +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/tox.ini +0 -0
- {documenteer-1.2.1 → documenteer-1.2.2}/webpack.config.js +0 -0
|
@@ -2,6 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
<!-- scriv-insert-here -->
|
|
4
4
|
|
|
5
|
+
<a id='changelog-1.2.2'></a>
|
|
6
|
+
## 1.2.2 (2024-04-11)
|
|
7
|
+
|
|
8
|
+
### Bug fixes
|
|
9
|
+
|
|
10
|
+
- Update `jira_uri_template` configuration default to `https://rubinobs.atlassian.net/browse/{issue}`. This will make all :jira:, :jirab:, and :jirap: roles point to the new Jira instance for Rubin Observatory.
|
|
11
|
+
- Drop `jira.lsstcorp.org` from the linkcheck ignore list defaults for `documenteer.config.guide` since that instance is no longer being used.
|
|
12
|
+
- Replace `jira.lsstcorp.org` URLs in documentation to `rubinobs.atlassian.net`.
|
|
13
|
+
|
|
5
14
|
<a id='changelog-1.2.1'></a>
|
|
6
15
|
## 1.2.1 (2024-04-02)
|
|
7
16
|
|
|
@@ -340,7 +349,7 @@ Fixes:
|
|
|
340
349
|
- Individual Stack packages now import `documenteer.conf.pipelinespkg` in their `conf.py` files.
|
|
341
350
|
|
|
342
351
|
The previous configuration sub-package, `documenteer.sphinxconf` is deprecated.
|
|
343
|
-
[[DM-20866](https://
|
|
352
|
+
[[DM-20866](https://rubinobs.atlassian.net/browse/DM-20866)]
|
|
344
353
|
|
|
345
354
|
Overall, the configurations are compatible with these exceptions:
|
|
346
355
|
|
|
@@ -363,13 +372,13 @@ Fixes:
|
|
|
363
372
|
For example, individual packages can add to the `EXCLUDE` tag.
|
|
364
373
|
By default, each package's `include` directory is included in the Doxygen build.
|
|
365
374
|
|
|
366
|
-
[[DM-22698](https://
|
|
375
|
+
[[DM-22698](https://rubinobs.atlassian.net/browse/DM-22698), [DM-23094](https://rubinobs.atlassian.net/browse/DM-23094), [DM-22461](https://rubinobs.atlassian.net/browse/DM-22461)]
|
|
367
376
|
|
|
368
377
|
- Improved Sphinx runner (`documenteer.sphinxrunner`).
|
|
369
|
-
[[DM-26768](https://
|
|
378
|
+
[[DM-26768](https://rubinobs.atlassian.net/browse/DM-26768)]
|
|
370
379
|
|
|
371
380
|
- Added static type checking using [mypy](https://mypy.readthedocs.io/en/stable/).
|
|
372
|
-
[[DM-22717](https://
|
|
381
|
+
[[DM-22717](https://rubinobs.atlassian.net/browse/DM-22717), [DM-26288](https://rubinobs.atlassian.net/browse/DM-26288)]
|
|
373
382
|
|
|
374
383
|
- Improved packaging, testing, and development environment:
|
|
375
384
|
|
|
@@ -381,7 +390,7 @@ Fixes:
|
|
|
381
390
|
- Migrated to `pre-commit` for running linters and code formatters.
|
|
382
391
|
- Migrated to GitHub Actions from Travis CI.
|
|
383
392
|
|
|
384
|
-
[`DM-22957 <https://
|
|
393
|
+
[`DM-22957 <https://rubinobs.atlassian.net/browse/DM-22957>`_, `DM-26288 <https://rubinobs.atlassian.net/browse/DM-26288>`_]
|
|
385
394
|
|
|
386
395
|
- Documentation improvements:
|
|
387
396
|
|
|
@@ -396,19 +405,19 @@ Fixes:
|
|
|
396
405
|
|
|
397
406
|
- Technote configuration now uses `yaml.safe_load` instead of `yaml.load`.
|
|
398
407
|
See the [pyyaml docs for details](https://github.com/yaml/pyyaml/wiki/PyYAML-yaml.load(input)-Deprecation).
|
|
399
|
-
[[DM-22537](https://
|
|
408
|
+
[[DM-22537](https://rubinobs.atlassian.net/browse/DM-22537)]
|
|
400
409
|
|
|
401
410
|
## 0.5.4 (2019-11-03)
|
|
402
411
|
|
|
403
412
|
- This new version of the technote sphinx theme should fix the edition link in the sidebar for non-main editions.
|
|
404
|
-
[[DM-20839](https://
|
|
413
|
+
[[DM-20839](https://rubinobs.atlassian.net/browse/DM-20839)]
|
|
405
414
|
|
|
406
415
|
## 0.5.3 (2019-08-07)
|
|
407
416
|
|
|
408
417
|
- Enabled the `html_use_index` and `html_domain_indices` configurations for Stack documentation projects to enable automatic index generation.
|
|
409
418
|
The `genindex` contains links to all command-line options and Python objects (Sphinx's domains).
|
|
410
419
|
This also opens us up to a more general content index by way of the [index directive](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#index-generating-markup).
|
|
411
|
-
[[DM-20850](https://
|
|
420
|
+
[[DM-20850](https://rubinobs.atlassian.net/browse/DM-20850)]
|
|
412
421
|
|
|
413
422
|
- Fixed compatibility with docutils 0.15.
|
|
414
423
|
Now Sphinx will control which version of docutils is used, which should now be 0.15.
|
|
@@ -419,7 +428,7 @@ Fixes:
|
|
|
419
428
|
|
|
420
429
|
- Add [sphinxcontrib.autoprogram](https://sphinxcontrib-autoprogram.readthedocs.io/en/stable/) to enable automated reference documentation of argparse-based command-line scripts.
|
|
421
430
|
This extension is available with the `documenteer[pipelines]` installation extra and enabled by default for LSST Science Pipelines projects.
|
|
422
|
-
[[DM-20767](https://
|
|
431
|
+
[[DM-20767](https://rubinobs.atlassian.net/browse/)]
|
|
423
432
|
|
|
424
433
|
- Update the official list of tested and supported Python versions to Python 3.6 and 3.7.
|
|
425
434
|
|
|
@@ -433,7 +442,7 @@ Fixes:
|
|
|
433
442
|
- The stack documentation build now requires that packages be explicitly required by the main documentation project's EUPS table file.
|
|
434
443
|
Before, a package only needed a `doc/manifest.yaml` file and to be currently set up in the EUPS environment to be linked into the documentation build.
|
|
435
444
|
This would lead to packages being included in a documentation build despite not being a part of that stack product.
|
|
436
|
-
[[DM-17765](https://
|
|
445
|
+
[[DM-17765](https://rubinobs.atlassian.net/browse/DM-17765)]
|
|
437
446
|
|
|
438
447
|
- This release adds the [sphinx-jinja](https://github.com/tardyp/sphinx-jinja) extension for `documenteer[pipelines]` installations.
|
|
439
448
|
This extension makes it possible to dynamically create content with Jinja templating.
|
|
@@ -453,7 +462,7 @@ Fixes:
|
|
|
453
462
|
- `pipelines_demo_ref`
|
|
454
463
|
|
|
455
464
|
These variables are accessible from the `jinja` directive's context.
|
|
456
|
-
[[DM-17065](https://
|
|
465
|
+
[[DM-17065](https://rubinobs.atlassian.net/browse/DM-17065)]
|
|
457
466
|
|
|
458
467
|
- This release also added some new substitutions to the `rst_epilog` of stack-based projects:
|
|
459
468
|
|
|
@@ -467,7 +476,7 @@ Fixes:
|
|
|
467
476
|
|
|
468
477
|
- The project's name is also used as the `logotext` at the top of the page for stack-based projects.
|
|
469
478
|
Previously the `logotext` would always be "LSST Science Pipelines."
|
|
470
|
-
[[DM-17263](https://
|
|
479
|
+
[[DM-17263](https://rubinobs.atlassian.net/browse/DM-17263)]
|
|
471
480
|
|
|
472
481
|
- Added the following projects to the intersphinx inventory of stack-based projects:
|
|
473
482
|
|
|
@@ -481,18 +490,18 @@ Fixes:
|
|
|
481
490
|
## 0.4.4 (2019-02-05)
|
|
482
491
|
|
|
483
492
|
- Updated scikit-learn's intersphinx inventory URL (now available as HTTPS) in the `documenteer.sphinxconfig.stackconf`.
|
|
484
|
-
- Fixed the `lsst-task-config-subtasks` directive so that it can introspect items in an `lsst.pex.config` `Registry` that are wrapped by a `ConfigurableWrapper`. [(DM-17661)[https://
|
|
493
|
+
- Fixed the `lsst-task-config-subtasks` directive so that it can introspect items in an `lsst.pex.config` `Registry` that are wrapped by a `ConfigurableWrapper`. [(DM-17661)[https://rubinobs.atlassian.net/browse/DM-17661]]
|
|
485
494
|
|
|
486
495
|
## 0.4.3 (2018-11-30)
|
|
487
496
|
|
|
488
497
|
- Pin [sphinxcontrib-bibtex](https://github.com/mcmtroffaes/sphinxcontrib-bibtex) to version 0.4.0 since later versions are incompatible with Sphinx <1.8.0.
|
|
489
|
-
[[DM-16651](https://
|
|
498
|
+
[[DM-16651](https://rubinobs.atlassian.net/browse/DM-16651)]
|
|
490
499
|
|
|
491
500
|
## 0.4.2 (2018-11-01)
|
|
492
501
|
|
|
493
502
|
- Handle cases where an object does not have a docstring in `documenteer.sphinxext.lssttasks.taskutils.get_docstring`.
|
|
494
503
|
This improves the reliability of the `lsst-task-api-summary` directive.
|
|
495
|
-
See (DM-16102)(https://
|
|
504
|
+
See (DM-16102)(https://rubinobs.atlassian.net/browse/DM-16102).
|
|
496
505
|
|
|
497
506
|
## 0.4.1 (2018-10-15)
|
|
498
507
|
|
|
@@ -521,7 +530,7 @@ Fixes:
|
|
|
521
530
|
This configuration is critical:
|
|
522
531
|
|
|
523
532
|
1. It is actually responsible for ensuring that inherited members of classes appear in our docs.
|
|
524
|
-
2. Without this, classes that have a `__slots__` attribute (typically through inheritance of a `collections.abc` class) won't have *any* of their members documented. See (DM-16102)(https://
|
|
533
|
+
2. Without this, classes that have a `__slots__` attribute (typically through inheritance of a `collections.abc` class) won't have *any* of their members documented. See (DM-16102)(https://rubinobs.atlassian.net/browse/DM-16102) for discussion.
|
|
525
534
|
|
|
526
535
|
- `todo` directives are now hidden when using `build_pipelines_lsst_io_configs`.
|
|
527
536
|
They are still shown, by default, for standalone package documentation builds, which are primarily developer-facing.
|
|
@@ -650,7 +659,7 @@ Fixes:
|
|
|
650
659
|
|
|
651
660
|
## 0.1.10 (2016-12-14)
|
|
652
661
|
|
|
653
|
-
Includes prototype support for LSST Science Pipelines documentation, as part of `DM-6199 <https://
|
|
662
|
+
Includes prototype support for LSST Science Pipelines documentation, as part of `DM-6199 <https://rubinobs.atlassian.net/browse/DM-6199>`__:
|
|
654
663
|
|
|
655
664
|
- Added dependencies to [breathe](http://breathe.readthedocs.io/en/latest/), [astropy-helpers](https://github.com/astropy/astropy-helpers) and the [lsst-sphinx-bootstrap-theme](https://github.com/lsst-sqre/lsst-sphinx-bootstrap-theme) to generally coordinate LSST Science Pipelines documentation dependencies.
|
|
656
665
|
- Created `documenteer.sphinxconfig.stackconf` module to centrally coordinate Science Pipelines documentation configuration. Much of the configuration is based on [astropy-helper's Sphinx configuration](https://github.com/astropy/astropy-helpers/blob/master/astropy_helpers/sphinx/conf.py) since the LSST Science Pipelines documentation is heavily based upon Astropy's Sphinx theme and API reference generation infrastructure.
|
|
@@ -685,7 +694,7 @@ Includes prototype support for LSST Science Pipelines documentation, as part of
|
|
|
685
694
|
|
|
686
695
|
## 0.1.3 (2016-05-24)
|
|
687
696
|
|
|
688
|
-
- Add roles for linking to ls.st links: `lpm`, `ldm`, and `lse`. DM-6181.
|
|
697
|
+
- Add roles for linking to `ls.st` links: `lpm`, `ldm`, and `lse`. DM-6181.
|
|
689
698
|
- Add roles for linking to JIRA tickets: `jira`, `jirab`, and `jirap`. DM-6181.
|
|
690
699
|
|
|
691
700
|
## 0.1.2 (2016-05-14)
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"\n",
|
|
22
22
|
"Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin facilisis pharetra neque, at semper nulla mattis auctor. Proin semper mollis enim eget interdum. Mauris eleifend eget diam vitae bibendum. Praesent ut aliquet odio, sodales imperdiet nisi. Nam interdum imperdiet tortor sed fringilla. Maecenas efficitur mi sodales nulla commodo rutrum. Ut ornare diam quam, sed commodo turpis aliquam et. In nec enim consequat, suscipit tortor sit amet, luctus ante. Integer dictum augue diam, non pulvinar massa euismod in. Morbi viverra condimentum auctor. Nullam et metus mauris. Cras risus ex, porta sit amet nibh et, dapibus auctor leo.\n",
|
|
23
23
|
"\n",
|
|
24
|
-
"A parenthetical citation {cite:p}`
|
|
24
|
+
"A parenthetical citation {cite:p}`SQR-083`. And a textual citation {cite:t}`SQR-083`."
|
|
25
25
|
]
|
|
26
26
|
},
|
|
27
27
|
{
|
|
@@ -10,7 +10,7 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin facilisis pharetr
|
|
|
10
10
|
|
|
11
11
|
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin facilisis pharetra neque, at semper nulla mattis auctor. Proin semper mollis enim eget interdum. Mauris eleifend eget diam vitae bibendum. Praesent ut aliquet odio, sodales imperdiet nisi. Nam interdum imperdiet tortor sed fringilla. Maecenas efficitur mi sodales nulla commodo rutrum. Ut ornare diam quam, sed commodo turpis aliquam et. In nec enim consequat, suscipit tortor sit amet, luctus ante. Integer dictum augue diam, non pulvinar massa euismod in. Morbi viverra condimentum auctor. Nullam et metus mauris. Cras risus ex, porta sit amet nibh et, dapibus auctor leo.
|
|
12
12
|
|
|
13
|
-
A parenthetical citation {cite:p}`
|
|
13
|
+
A parenthetical citation {cite:p}`SQR-083`. And a textual citation {cite:t}`SQR-083`.
|
|
14
14
|
|
|
15
15
|
## Method
|
|
16
16
|
|
|
@@ -16,7 +16,7 @@ Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin facilisis pharetr
|
|
|
16
16
|
|
|
17
17
|
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin facilisis pharetra neque, at semper nulla mattis auctor. Proin semper mollis enim eget interdum. Mauris eleifend eget diam vitae bibendum. Praesent ut aliquet odio, sodales imperdiet nisi. Nam interdum imperdiet tortor sed fringilla. Maecenas efficitur mi sodales nulla commodo rutrum. Ut ornare diam quam, sed commodo turpis aliquam et. In nec enim consequat, suscipit tortor sit amet, luctus ante. Integer dictum augue diam, non pulvinar massa euismod in. Morbi viverra condimentum auctor. Nullam et metus mauris. Cras risus ex, porta sit amet nibh et, dapibus auctor leo.
|
|
18
18
|
|
|
19
|
-
A parenthetical citation :cite:p:`
|
|
19
|
+
A parenthetical citation :cite:p:`SQR-083`. And a textual citation :cite:t:`SQR-083`.
|
|
20
20
|
|
|
21
21
|
Method
|
|
22
22
|
======
|
|
@@ -2,6 +2,15 @@
|
|
|
2
2
|
|
|
3
3
|
<!-- scriv-insert-here -->
|
|
4
4
|
|
|
5
|
+
<a id='changelog-1.2.2'></a>
|
|
6
|
+
## 1.2.2 (2024-04-11)
|
|
7
|
+
|
|
8
|
+
### Bug fixes
|
|
9
|
+
|
|
10
|
+
- Update `jira_uri_template` configuration default to `https://rubinobs.atlassian.net/browse/{issue}`. This will make all :jira:, :jirab:, and :jirap: roles point to the new Jira instance for Rubin Observatory.
|
|
11
|
+
- Drop `jira.lsstcorp.org` from the linkcheck ignore list defaults for `documenteer.config.guide` since that instance is no longer being used.
|
|
12
|
+
- Replace `jira.lsstcorp.org` URLs in documentation to `rubinobs.atlassian.net`.
|
|
13
|
+
|
|
5
14
|
<a id='changelog-1.2.1'></a>
|
|
6
15
|
## 1.2.1 (2024-04-02)
|
|
7
16
|
|
|
@@ -340,7 +349,7 @@ Fixes:
|
|
|
340
349
|
- Individual Stack packages now import `documenteer.conf.pipelinespkg` in their `conf.py` files.
|
|
341
350
|
|
|
342
351
|
The previous configuration sub-package, `documenteer.sphinxconf` is deprecated.
|
|
343
|
-
[[DM-20866](https://
|
|
352
|
+
[[DM-20866](https://rubinobs.atlassian.net/browse/DM-20866)]
|
|
344
353
|
|
|
345
354
|
Overall, the configurations are compatible with these exceptions:
|
|
346
355
|
|
|
@@ -363,13 +372,13 @@ Fixes:
|
|
|
363
372
|
For example, individual packages can add to the `EXCLUDE` tag.
|
|
364
373
|
By default, each package's `include` directory is included in the Doxygen build.
|
|
365
374
|
|
|
366
|
-
[[DM-22698](https://
|
|
375
|
+
[[DM-22698](https://rubinobs.atlassian.net/browse/DM-22698), [DM-23094](https://rubinobs.atlassian.net/browse/DM-23094), [DM-22461](https://rubinobs.atlassian.net/browse/DM-22461)]
|
|
367
376
|
|
|
368
377
|
- Improved Sphinx runner (`documenteer.sphinxrunner`).
|
|
369
|
-
[[DM-26768](https://
|
|
378
|
+
[[DM-26768](https://rubinobs.atlassian.net/browse/DM-26768)]
|
|
370
379
|
|
|
371
380
|
- Added static type checking using [mypy](https://mypy.readthedocs.io/en/stable/).
|
|
372
|
-
[[DM-22717](https://
|
|
381
|
+
[[DM-22717](https://rubinobs.atlassian.net/browse/DM-22717), [DM-26288](https://rubinobs.atlassian.net/browse/DM-26288)]
|
|
373
382
|
|
|
374
383
|
- Improved packaging, testing, and development environment:
|
|
375
384
|
|
|
@@ -381,7 +390,7 @@ Fixes:
|
|
|
381
390
|
- Migrated to `pre-commit` for running linters and code formatters.
|
|
382
391
|
- Migrated to GitHub Actions from Travis CI.
|
|
383
392
|
|
|
384
|
-
[`DM-22957 <https://
|
|
393
|
+
[`DM-22957 <https://rubinobs.atlassian.net/browse/DM-22957>`_, `DM-26288 <https://rubinobs.atlassian.net/browse/DM-26288>`_]
|
|
385
394
|
|
|
386
395
|
- Documentation improvements:
|
|
387
396
|
|
|
@@ -396,19 +405,19 @@ Fixes:
|
|
|
396
405
|
|
|
397
406
|
- Technote configuration now uses `yaml.safe_load` instead of `yaml.load`.
|
|
398
407
|
See the [pyyaml docs for details](https://github.com/yaml/pyyaml/wiki/PyYAML-yaml.load(input)-Deprecation).
|
|
399
|
-
[[DM-22537](https://
|
|
408
|
+
[[DM-22537](https://rubinobs.atlassian.net/browse/DM-22537)]
|
|
400
409
|
|
|
401
410
|
## 0.5.4 (2019-11-03)
|
|
402
411
|
|
|
403
412
|
- This new version of the technote sphinx theme should fix the edition link in the sidebar for non-main editions.
|
|
404
|
-
[[DM-20839](https://
|
|
413
|
+
[[DM-20839](https://rubinobs.atlassian.net/browse/DM-20839)]
|
|
405
414
|
|
|
406
415
|
## 0.5.3 (2019-08-07)
|
|
407
416
|
|
|
408
417
|
- Enabled the `html_use_index` and `html_domain_indices` configurations for Stack documentation projects to enable automatic index generation.
|
|
409
418
|
The `genindex` contains links to all command-line options and Python objects (Sphinx's domains).
|
|
410
419
|
This also opens us up to a more general content index by way of the [index directive](https://www.sphinx-doc.org/en/master/usage/restructuredtext/directives.html#index-generating-markup).
|
|
411
|
-
[[DM-20850](https://
|
|
420
|
+
[[DM-20850](https://rubinobs.atlassian.net/browse/DM-20850)]
|
|
412
421
|
|
|
413
422
|
- Fixed compatibility with docutils 0.15.
|
|
414
423
|
Now Sphinx will control which version of docutils is used, which should now be 0.15.
|
|
@@ -419,7 +428,7 @@ Fixes:
|
|
|
419
428
|
|
|
420
429
|
- Add [sphinxcontrib.autoprogram](https://sphinxcontrib-autoprogram.readthedocs.io/en/stable/) to enable automated reference documentation of argparse-based command-line scripts.
|
|
421
430
|
This extension is available with the `documenteer[pipelines]` installation extra and enabled by default for LSST Science Pipelines projects.
|
|
422
|
-
[[DM-20767](https://
|
|
431
|
+
[[DM-20767](https://rubinobs.atlassian.net/browse/)]
|
|
423
432
|
|
|
424
433
|
- Update the official list of tested and supported Python versions to Python 3.6 and 3.7.
|
|
425
434
|
|
|
@@ -433,7 +442,7 @@ Fixes:
|
|
|
433
442
|
- The stack documentation build now requires that packages be explicitly required by the main documentation project's EUPS table file.
|
|
434
443
|
Before, a package only needed a `doc/manifest.yaml` file and to be currently set up in the EUPS environment to be linked into the documentation build.
|
|
435
444
|
This would lead to packages being included in a documentation build despite not being a part of that stack product.
|
|
436
|
-
[[DM-17765](https://
|
|
445
|
+
[[DM-17765](https://rubinobs.atlassian.net/browse/DM-17765)]
|
|
437
446
|
|
|
438
447
|
- This release adds the [sphinx-jinja](https://github.com/tardyp/sphinx-jinja) extension for `documenteer[pipelines]` installations.
|
|
439
448
|
This extension makes it possible to dynamically create content with Jinja templating.
|
|
@@ -453,7 +462,7 @@ Fixes:
|
|
|
453
462
|
- `pipelines_demo_ref`
|
|
454
463
|
|
|
455
464
|
These variables are accessible from the `jinja` directive's context.
|
|
456
|
-
[[DM-17065](https://
|
|
465
|
+
[[DM-17065](https://rubinobs.atlassian.net/browse/DM-17065)]
|
|
457
466
|
|
|
458
467
|
- This release also added some new substitutions to the `rst_epilog` of stack-based projects:
|
|
459
468
|
|
|
@@ -467,7 +476,7 @@ Fixes:
|
|
|
467
476
|
|
|
468
477
|
- The project's name is also used as the `logotext` at the top of the page for stack-based projects.
|
|
469
478
|
Previously the `logotext` would always be "LSST Science Pipelines."
|
|
470
|
-
[[DM-17263](https://
|
|
479
|
+
[[DM-17263](https://rubinobs.atlassian.net/browse/DM-17263)]
|
|
471
480
|
|
|
472
481
|
- Added the following projects to the intersphinx inventory of stack-based projects:
|
|
473
482
|
|
|
@@ -481,18 +490,18 @@ Fixes:
|
|
|
481
490
|
## 0.4.4 (2019-02-05)
|
|
482
491
|
|
|
483
492
|
- Updated scikit-learn's intersphinx inventory URL (now available as HTTPS) in the `documenteer.sphinxconfig.stackconf`.
|
|
484
|
-
- Fixed the `lsst-task-config-subtasks` directive so that it can introspect items in an `lsst.pex.config` `Registry` that are wrapped by a `ConfigurableWrapper`. [(DM-17661)[https://
|
|
493
|
+
- Fixed the `lsst-task-config-subtasks` directive so that it can introspect items in an `lsst.pex.config` `Registry` that are wrapped by a `ConfigurableWrapper`. [(DM-17661)[https://rubinobs.atlassian.net/browse/DM-17661]]
|
|
485
494
|
|
|
486
495
|
## 0.4.3 (2018-11-30)
|
|
487
496
|
|
|
488
497
|
- Pin [sphinxcontrib-bibtex](https://github.com/mcmtroffaes/sphinxcontrib-bibtex) to version 0.4.0 since later versions are incompatible with Sphinx <1.8.0.
|
|
489
|
-
[[DM-16651](https://
|
|
498
|
+
[[DM-16651](https://rubinobs.atlassian.net/browse/DM-16651)]
|
|
490
499
|
|
|
491
500
|
## 0.4.2 (2018-11-01)
|
|
492
501
|
|
|
493
502
|
- Handle cases where an object does not have a docstring in `documenteer.sphinxext.lssttasks.taskutils.get_docstring`.
|
|
494
503
|
This improves the reliability of the `lsst-task-api-summary` directive.
|
|
495
|
-
See (DM-16102)(https://
|
|
504
|
+
See (DM-16102)(https://rubinobs.atlassian.net/browse/DM-16102).
|
|
496
505
|
|
|
497
506
|
## 0.4.1 (2018-10-15)
|
|
498
507
|
|
|
@@ -521,7 +530,7 @@ Fixes:
|
|
|
521
530
|
This configuration is critical:
|
|
522
531
|
|
|
523
532
|
1. It is actually responsible for ensuring that inherited members of classes appear in our docs.
|
|
524
|
-
2. Without this, classes that have a `__slots__` attribute (typically through inheritance of a `collections.abc` class) won't have *any* of their members documented. See (DM-16102)(https://
|
|
533
|
+
2. Without this, classes that have a `__slots__` attribute (typically through inheritance of a `collections.abc` class) won't have *any* of their members documented. See (DM-16102)(https://rubinobs.atlassian.net/browse/DM-16102) for discussion.
|
|
525
534
|
|
|
526
535
|
- `todo` directives are now hidden when using `build_pipelines_lsst_io_configs`.
|
|
527
536
|
They are still shown, by default, for standalone package documentation builds, which are primarily developer-facing.
|
|
@@ -650,7 +659,7 @@ Fixes:
|
|
|
650
659
|
|
|
651
660
|
## 0.1.10 (2016-12-14)
|
|
652
661
|
|
|
653
|
-
Includes prototype support for LSST Science Pipelines documentation, as part of `DM-6199 <https://
|
|
662
|
+
Includes prototype support for LSST Science Pipelines documentation, as part of `DM-6199 <https://rubinobs.atlassian.net/browse/DM-6199>`__:
|
|
654
663
|
|
|
655
664
|
- Added dependencies to [breathe](http://breathe.readthedocs.io/en/latest/), [astropy-helpers](https://github.com/astropy/astropy-helpers) and the [lsst-sphinx-bootstrap-theme](https://github.com/lsst-sqre/lsst-sphinx-bootstrap-theme) to generally coordinate LSST Science Pipelines documentation dependencies.
|
|
656
665
|
- Created `documenteer.sphinxconfig.stackconf` module to centrally coordinate Science Pipelines documentation configuration. Much of the configuration is based on [astropy-helper's Sphinx configuration](https://github.com/astropy/astropy-helpers/blob/master/astropy_helpers/sphinx/conf.py) since the LSST Science Pipelines documentation is heavily based upon Astropy's Sphinx theme and API reference generation infrastructure.
|
|
@@ -685,7 +694,7 @@ Includes prototype support for LSST Science Pipelines documentation, as part of
|
|
|
685
694
|
|
|
686
695
|
## 0.1.3 (2016-05-24)
|
|
687
696
|
|
|
688
|
-
- Add roles for linking to ls.st links: `lpm`, `ldm`, and `lse`. DM-6181.
|
|
697
|
+
- Add roles for linking to `ls.st` links: `lpm`, `ldm`, and `lse`. DM-6181.
|
|
689
698
|
- Add roles for linking to JIRA tickets: `jira`, `jirab`, and `jirap`. DM-6181.
|
|
690
699
|
|
|
691
700
|
## 0.1.2 (2016-05-14)
|
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
Jira reference roles
|
|
5
5
|
####################
|
|
6
6
|
|
|
7
|
-
Documenteer provides reStructuredText roles to simplify linking to issues in LSST's Jira ticketing system at https://
|
|
7
|
+
Documenteer provides reStructuredText roles to simplify linking to issues in LSST's Jira ticketing system at https://rubinobs.atlassian.net.
|
|
8
8
|
|
|
9
9
|
To use these roles, add the ``documenteer.ext.jira`` extension to your :file:`conf.py` file:
|
|
10
10
|
|
|
@@ -234,9 +234,8 @@ intersphinx_cache_limit = 5 # days
|
|
|
234
234
|
|
|
235
235
|
linkcheck_retries = 2
|
|
236
236
|
|
|
237
|
-
# Tucson IT infrastructure sometimes goes down or has TLS issues
|
|
238
237
|
linkcheck_ignore = [
|
|
239
|
-
|
|
238
|
+
# Tucson IT infrastructure sometimes goes down or has TLS issues
|
|
240
239
|
r"^https://ls.st/",
|
|
241
240
|
]
|
|
242
241
|
_conf.append_linkcheck_ignore(linkcheck_ignore)
|
|
@@ -150,7 +150,7 @@ autoclass_content = "class"
|
|
|
150
150
|
# methods.
|
|
151
151
|
# NOTE: We want to used `inherited-members`, but it seems to be causing
|
|
152
152
|
# documentation duplication in the automodapi listings. We're leaving
|
|
153
|
-
# this out for now. See https://
|
|
153
|
+
# this out for now. See https://rubinobs.atlassian.net/browse/DM-14782 for
|
|
154
154
|
# additional notes.
|
|
155
155
|
# NOTE: Without inherited members set, special-members doesn't need seem
|
|
156
156
|
# to have an effect (even for special members where the docstrings are
|
|
@@ -153,7 +153,7 @@ def jira_parens_role(
|
|
|
153
153
|
def setup(app):
|
|
154
154
|
app.add_config_value(
|
|
155
155
|
"jira_uri_template",
|
|
156
|
-
default="https://
|
|
156
|
+
default="https://rubinobs.atlassian.net/browse/{ticket}",
|
|
157
157
|
rebuild="html",
|
|
158
158
|
)
|
|
159
159
|
app.add_role("jira", jira_role)
|
|
@@ -139,12 +139,12 @@ def test_append_linkcheck_ignore() -> None:
|
|
|
139
139
|
config = DocumenteerConfig.load(EXAMPLE)
|
|
140
140
|
|
|
141
141
|
linkcheck_ignore = [
|
|
142
|
-
r"^https://
|
|
142
|
+
r"^https://rubinobs.atlassian.net/browse/",
|
|
143
143
|
r"^https://ls.st/",
|
|
144
144
|
]
|
|
145
145
|
config.append_linkcheck_ignore(linkcheck_ignore)
|
|
146
146
|
assert linkcheck_ignore == [
|
|
147
|
-
r"^https://
|
|
147
|
+
r"^https://rubinobs.atlassian.net/browse/",
|
|
148
148
|
r"^https://ls.st/",
|
|
149
149
|
r"^https://confluence.lsstcorp.org/",
|
|
150
150
|
]
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|