If you’ve been paying attention to the community docs lately, we’ve been going through a lot of changes with infrastructure. We’ve recently completed a lift and shift of the
docsite folder from the
ansible/ansible repository to the
Moving the docs to a separate repo resolved some issues that were impacting workflows and shared ownership for both the core team and the community. But it has also given us the opportunity to solve a particular challenge, namely that docs across the project ecosystem are missing top-level content that shows how to use all the tooling together for specific use cases.
For example @Andersson007 has recently authored a getting started with execution environments tutorial that combines projects like navigator and builder with community collections: Getting started with Execution Environments — Ansible Documentation
This getting started doesn’t quite fit in the Ansible package docs and it doesn’t fit in
ansible-core docs either. We could create yet another repository but that just makes it more difficult for contributors.
So how about we expand the
ansible-documentation repository to include the ecosystem? We could create a file system layout similar to this:
docs/ ├─ core/ │ ├─ rst/ │ │ ├─ index.rst ├─ ecosystem/ │ ├─ rst/ │ │ ├─ index.rst ├─ package/ │ ├─ rst/ │ │ ├─ index.rst
ansible-documentation/ecosystem folder holds a new docsite that is intended for cross-project tutorials and how tos.