Skip to content

Change log

Jump to bottom
Colm Bhandal edited this page Sep 20, 2023 · 25 revisions

For the full change log, see the commits or pull requests. This change log lists big and relevant changes that every user of the starter pack should be aware of and that might require an action.

2023/09/20

Added some common terms to the custom wordlist, including Canonical-specific terms.

2023/08/31

Unpinned the Sphinx version again since the issues (mentioned below, 2023/08/21) are now fixed.

2023/08/22

Switched the GitHub documentation checks to use a reusable workflow.

2023/08/21

Pinned the Sphinx version to prevent some current bugs (that will hopefully be resolved soon):

Therefore, we currently pin the Sphinx version to 7.1.2.

2023/08/16

Added a GitHub bot that can be used to sync issues from GitHub to Jira. See (Optional) Synchronise GitHub issues to Jira for instructions on how to set it up.

2023/07/10

Summary of relevant changes for the last month:

  • Moved the content files that were meant to show how to set up Diataxis documentation to a separate repository: https://github.com/canonical/example-product-documentation

    This leaves only the files that cover configuration and styling in the starter pack, which should make it easier to keep documentation sets in sync with the starter pack.

  • Added a header to the documentation to integrate the documentation (hosted on readthedocs) with the product website. The header can be customised with the product name and logo, and you can add custom links to the "More resources" section.

    See https://github.com/canonical/sphinx-docs-starter-pack#configure-the-header

  • Split the configuration file into a common conf.py file and a custom custom_conf.py file. All project-specific configuration should go into the custom_conf.py file, while the conf.py file should not be touched. This should make it easier to keep the configuration in sync with the starter pack.

Clone this wiki locally