Note: Presentation slide decks are now available at https://ansible.github.io/community/decks/community-day-2023.05/ - it's not complete yet, please check back for updates! Link to this HackMD: https://hackmd.io/@ansible-community/ACD2023-Boston Part of Red Hat Summit / AnsibleFest 2023 Date: Monday May 22, 2023 Time: 08:30 - 18:00 EDT Location: Westin Boston Seaport District Address: 425 Summer Street, Boston, Massachusetts, 02210 USA Rooms: Commonwealth Ballroom (General Session and Breakout 1), Grand Ballroom C (Breakout 2) Registration: After you register for Red Hat Summit, please add Ansible Community Day to your schedule6/9/2023
This is a WIP and has not been presented to the Ansible community. If we look at docs.ansible.com today we can see there are two categories, or domains, for the set of community docs: docs.ansible.com/ansible/ docs.ansible.com/ecosystem.html The Ansible community team proposes various high-level actions that seek to improve organization of the content set along those categories. Intended outcomes6/7/2023
This document follows on from the Decoupling core and package docs proposal to focus on Red Hat Ansible Automation Platform content on docs.ansible.com. Without delving into the historical reasons that lead to the current state, the docs.ansible.com/platform.html page holds documentation for Red Hat customers with Ansible Automation Controller subscriptions. This results in a silo of content that is confusing for Red Hat customers and out of place within the Ansible community. To break down this silo, there are two basic options: Option 1: Integrate Controller docs downstream. Establish conversion workflows that migrate Controller docs into the Red Hat internal publishing system for access.redhat. Over time the Controller docs could be integrated with the rest of the downstream content on but it would require substantial effort from the Red Hat docs team, including ownership and maintenance of the conversion workflows along with content edits and rewrites for style guide adherence. Option 2: Identify content in the Controller doc set that is specific to having a Red Hat subscription and do a once-off conversion and handover to the Red Hat docs team. The rest of the Controller doc set becomes the AWX project documentation and joins the Ansible ecosystem on Read The Docs. Consider that:6/7/2023
As part of the effort to decouple from the package docs, Ansible Core docs were tested with the RTD Sphinx build using the following configuration: python: install: - requirements: ./requirements.txt - requirements: ./test/sanity/code-smell/docs-build.requirements.txt sphinx: builder: dirhtml configuration: docs/docsite/rst/conf.py Here are details from the RTD run:6/7/2023
By clicking below, you agree to our terms of service.
New to HackMD? Sign up