0.41.0

Release Summary

Feature and bugfix release.

Minor Changes

• Add --fail-on-error to all antsibull-docs subcommands for usage in CI (#393).
• Allow to select a different Sphinx theme for antsibull-docs sphinx-init with the new --sphinx-theme option (#392).
• Fully implement antsibull-docs collection. So far --current was required (#383).
• Mention the plugin type more prominently in the documentation (#364).
• Remove email addresses and (!UNKNOWN) from plugin and role author names (#389).
• Support new keyword field in plugin documentations (#329).
• The conf.py generated by antsibull-docs sphinx-init will be set to try resolving intersphinx references to Ansible's devel docs instead of a concrete Ansible version (#391).

Bugfixes

• If plugin parsing fails for antsibull-docs plugin, handle this more gracefully (#393).
• Improve error message when plugin specified for antsibull-docs plugin cannot be found (#383).
• When using --use-html-blobs, malformed HTML was generated for parameter aliases (#388).

0.40.2

Release Summary

Bugfix release.

Bugfixes

• Fix rsync call when antsibull-docs sphinx-init is used with --squash-hieararchy (#382).
• Fix invalid HTML in return value RST tables. Closing </div> were missing for a wrapping <div> of every content cell, causing problems with some text-based browsers (https://github.com/ansible-community/antsibull/issues/386, #387).
• Work around Python argparse bug by using vendored class for all Python versions until the bug is fixed in argparse. This makes --help work for all antsibull-docs subcommands (#384).

0.40.1

Release Summary

Bugfix release.

Bugfixes

• Fix bug in collection enum for docs generation, which caused role FQCNs to be mangled (#379).

0.40.0

Release Summary

Feature and bugfix release.

Major Changes

• Responsive parameter and return value tables. Also use RST tables instead of HTML blobs (#335).

Minor Changes

• Add a changelog (#378).
• Allow to specify collection_cache in config file (#375).
• Allow to still use HTML blobs for parameter and return value tables. This can be controlled by a CLI option --use-html-blobs and by a global config option use_html_blobs (#360).
• Avoid prereleases when creating the .build file in antsibull-build new-acd. The old behavior of including them can be obtained by passing the --allow-prereleases option (#298).
• Change ansible-base references in documentation and code to ansible-core where it makes sense (#353).
• During docs build, only write/copy files to the destination that have changed assuming they are not too large (#374).
• Improve build-ansible.sh script integrated in the release tarball (#369).
• Improve galaxy-requirements.yaml generation (#350).
• Mention new options in the porting guide (#363).
• Modify thread_max default value from 80 to 8 (#365, #370).
• Move modules to beginning of plugin index (#336).
• Remove unnecessary Python 2 boilerplates (#371).
• Simplify ansible-core dependency in setup.py with compatibility operator (#346).
• Split antsibull-build single subcommand into prepare and rebuild-single subcommand (#341).
• Stop using deprecated Python standard library distutils.version (#372).
• Various improvements to the build role (#338).

Deprecated Features

• The antsibull-build single subcommand is deprecated. Use the prepare and rebuild-single subcommands instead (#341).

Bugfixes

• Fix rsync flags in build scripts generated by antsibull-docs sphinx-init to allow Sphinx to not rebuild unchanged files (#357).
• Fix boolean logic error when --skip-indexes was used in antsibull-docs (#377).
• Fix feature freeze handling after Beta 1 in build role (#337).
• Require Python 3.8 for Ansible 5 (#345).

0.39.2

• Fixes an incompatibility with antsibull-lint with Python 3.9.8.
• Improves and extends the Ansible build role and its tests.

0.39.1

• Fixes M(...) when used in HTML blobs.
• Improve wait on HTTP retries.

0.39.0

Docs generation:

• Improve boilerplate for ansible.builtin documentation
• Render choices in return value documentation
• Add atlernating background colors to option and return value tables

Also improves the Ansible release playbook/role.

0.38.2

Avoid creating role documentation for roles without argument spec. Avoid naming collision with Ansible Sphinx config's rst_epilog contents.

0.38.1

Fix for attributes support: also allow new support value N/A

0.38.0

Support CLI options for the ansible.builtin.ssh connection plugin, and support ansible-core 2.12 module/plugin attributes.