Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support for Ansible 9 docs #1273

Open
samccann opened this issue Apr 16, 2024 · 6 comments
Open

Support for Ansible 9 docs #1273

samccann opened this issue Apr 16, 2024 · 6 comments

Comments

@samccann
Copy link
Contributor

So today, the version switcher only has two options- latest, and devel.

But with the decision to have Ansible 9 around for longer, we have two options:

  • Continue to have only latest/devel in the version switcher, but publish updates to Ansible 9 docs at the direct url (aka docs.ansible.com/ansible/9/).
  • Add Ansible 9 to the version switcher and maintain that for the length of the release.
@ansible-documentation-bot ansible-documentation-bot bot added the needs_triage Needs a first human triage before being processed. label Apr 16, 2024
@samccann
Copy link
Contributor Author

First option is easy peasy. The second option involves getting into the version switcher. I 'think' it's fairly easy as well, but before we do that, wanted to see what folks think. @gotmax23 as the main proponent for the longer release cycle of Ansible 9, what are your thoughts?

@samccann
Copy link
Contributor Author

Related to #1250

@felixfontein
Copy link
Collaborator

I'm for having 9 in the version switcher :)

@oraNod
Copy link
Contributor

oraNod commented Apr 18, 2024

Throwing this out here but the migration to readthedocs will allow us to get rid of the custom version switcher. RTD provide a builtin version switcher with the widget which makes our custom one a bit redundant. I've been told was kind of hacked together anyway. It probably doesn't make much difference to this issue but might be worth consideration.

@gotmax23
Copy link
Collaborator

I also think 9 should be a standalone item in the version switcher.

@samccann samccann removed the needs_triage Needs a first human triage before being processed. label Apr 30, 2024
@samccann
Copy link
Contributor Author

Discussed in DaWGS:
1 - Yes, we will need to continue publishing Ansible 9 docs for the duration.
2 - Yes, we should include 9 in the versin switcher.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: 📋 Backlog
Development

No branches or pull requests

4 participants