---
tags: 'summit_2022_04'
---

# Demo on collection docs

In this demonstration [@felixfontein](https://github.com/felixfontein/) will show how to:
1. Install [antsibull-docs](https://pypi.org/project/antsibull-docs/),
2. How to use antsibull-docs to create a small Sphinx-based docsite for your collection ([example](https://ansible.fontein.de/collections/index.html)),
3. How to add extra documentation to your collection (that will also be included on docs.ansible.com when your collection is part of Ansible) in `docs/docsite/rst` and `docs/docsite/extra-docs.yml`,
4. How to add links to communication channels, other links, and an Edit on GitHub button in `docs/docsite/links.yml`.

All these features can be seen on https://docs.ansible.com/ansible/devel/collections/community/docker/: 3. is used for the scenario guide, and 4. is used for the buttons on that index page and for the buttons and Edit on GitHub link on https://docs.ansible.com/ansible/devel/collections/community/docker/docker_container_module.html.

The commands used in this talk: https://gist.github.com/felixfontein/c851fa4ef503c6394c82ad9f900077a7