You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ansible/docs/docsite/rst/user_guide
Toshio Kuratomi 9dda393d70
Collections docs generation (#59761)
* Build documentation for Ansible-2.10 (formerly known as ACD).

Builds plugin docs from collections whose source is on galaxy

The new command downloads collections from galaxy, then finds the
plugins inside of them to get the documentation for those plugins.

* Update the python syntax checks
  * docs builds can now require python 3.6+.

* Move plugin formatter code out to an external tool, antsibull-docs.
  Collection owners want to be able to extract docs for their own
  websites as well.
* The jinja2 filters, tests, and other support code have moved to antsibull
* Remove document_plugins as that has now been integrated into antsibull-docs

* Cleanup and bugfix to other build script code:
  * The Commands class needed to have its metaclass set for abstractmethod
    to work correctly
  * Fix lint issues in some command plugins

* Add the docs/docsite/rst/collections to .gitignore as
  everything in that directory will be generated so we don't want any of
  it saved in the git repository
* gitignore the build dir and remove edit docs link on module pages

* Add docs/rst/collections as a directory to remove on make clean
* Split the collections docs from the main docs

* remove version and edit on github
* remove version banner for just collections
* clarify examples need collection keyword defined

* Remove references to plugin documentation locations that no longer exist.
  * Perhaps the pages in plugins/*.rst should be deprecated
    altogether and their content moved?
  * If not, perhaps we want to rephrase and link into the collection
    documentation?
  * Or perhaps we want to link to the plugins which are present in
    collections/ansible/builtin?

* Remove PYTHONPATH from the build-ansible calls
  One of the design goals of the build-ansible.py script was for it to
  automatically set its library path to include the checkout of ansible
  and the library of code to implement itself.  Because it automatically
  includes the checkout of ansible, we don't need to set PYTHONPATH in
  the Makefile any longer.

* Create a command to only build ansible-base plugin docs
  * When building docs for devel, only build the ansible-base docs for
    now.  This is because antsibull needs support for building a "devel
    tree" of docs.  This can be changed once that is implemented
  * When building docs for the sanity tests, only build the ansible-base
    plugin docs for now.  Those are the docs which are in this repo so
    that seems appropriate for now.
4 years ago
..
shared_snippets
basic_concepts.rst
become.rst Collections docs generation (#59761) 4 years ago
collections_using.rst Collections docs generation (#59761) 4 years ago
command_line_tools.rst
connection_details.rst
guide_rolling_upgrade.rst
index.rst
intro.rst
intro_adhoc.rst
intro_bsd.rst
intro_dynamic_inventory.rst
intro_getting_started.rst
intro_inventory.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
intro_patterns.rst
intro_windows.rst
modules.rst Collections docs generation (#59761) 4 years ago
modules_intro.rst
modules_support.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbook_pathing.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks.rst
playbooks_advanced_syntax.rst
playbooks_async.rst
playbooks_best_practices.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_blocks.rst
playbooks_checkmode.rst
playbooks_conditionals.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_debugger.rst
playbooks_delegation.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_environment.rst
playbooks_error_handling.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_filters.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_filters_ipaddr.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_intro.rst
playbooks_lookups.rst
playbooks_loops.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_module_defaults.rst
playbooks_prompts.rst
playbooks_python_version.rst
playbooks_reuse.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_reuse_includes.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_reuse_roles.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_roles.rst
playbooks_special_topics.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_startnstep.rst
playbooks_strategies.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_tags.rst
playbooks_templating.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_tests.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_variables.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
playbooks_vars_facts.rst
playbooks_vault.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
plugin_filtering_config.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
quickstart.rst
sample_setup.rst
vault.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
windows.rst
windows_dsc.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
windows_faq.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
windows_performance.rst
windows_setup.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
windows_usage.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago
windows_winrm.rst Docs: User guide overhaul, part 5 (#70307) 4 years ago