antsibull-docs
antsibull-docs copied to clipboard
Tooling for building Ansible documentation
Fixes #203. Current version (Zeal 'Sections' screenshot of HTML docsite converted with [doc2dash](https://pypi.org/project/doc2dash/)):  The n-fold 'Requirements' section still shows up, but at least the references to all return values...
~~Includes #73.~~ This is the controversal part of #73, which allows modules to declare environment variable fallbacks for options. Related to https://github.com/ansible/ansible/pull/79471.
antsibull-docs analogon to https://github.com/ansible/ansible/pull/79370.
I tried creating a docset for a collection for use in Dash or Zeal with [doc2dash](https://doc2dash.hynek.me/en/stable/), and noticed that while the process works pretty well (except that the default theme...
Currently we have the following note at https://github.com/ansible-community/antsibull-docs/blob/main/src/antsibull_docs/data/docsite/plugin.rst.j2#L461 which says: `Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower...
That should use https://github.com/ansible-community/ansible-build-data/blob/main/8/collection-meta.yaml somehow.
From a recent [reddit post ](https://www.reddit.com/r/ansible/comments/s1kb8e/ansible_moduleplugins_docs_now_use_simplified/)asking users to evaluate the new tables using the following two links: https://docs.ansible.com/ansible/devel/collections/community/crypto/acme_certificate_module.html#parameters and https://docs.ansible.com/ansible/devel/collections/community/hashi_vault/hashi_vault_lookup.html#parameters. > I sometimes need to use a screen reader and...
We need an option for not mentioning the version number, otherwise any king of update in the version would require regenerating the docs, creating too much churn. This affects ability...