A new look for docs.ansible.com

Hi everyone!

I’d like to ask for the community’s feedback on changes to the layout plus look and feel of docs.ansible.com.

Before we point the subdomain to Read The Docs hosting, it’s probably a better approach to set everything up and prune some old pages. This will avoid doing clean up work after switching things over and rebuilding sitemaps, etc.

I’d like to ask for review on a branch of the community website that ports over all the content from the ansible/docsite landing pages: Add docsite templates by oraNod · Pull Request #475 · ansible-community/community-website · GitHub

If you just want to look at the preview build and provide feedback as a reply to this forum post, you can find it here: https://ansible-community-website--475.org.readthedocs.build/

Benefits this will have:

  • Combines the great design of the community website with the content journey based approach to the docsite
  • Moves to nikola as the SSG for the docsite instead of custom
  • (Hopefully) creates better (clearer) separation of content between the community distribution and Red Hat AAP
  • Avoids the need for “clean up” work after moving the subdomain to RTD

We’ll be discussing this at the DaWGs if you want to join us on Tuesday at 16.00 Irish time. Come on by and tell us what you think: https://matrix.to/#/#docs:ansible.com

4 Likes

Discussed in DaWGs and the consensus agrees with this change and is looking forward to having the new look/feel for the docs.ansible.com front pages :slight_smile:

2 Likes

https://ansible-community-website--475.org.readthedocs.build/ looks great!

2 Likes

@felixfontein Hey, @samccann and I were chatting about this PR earlier. We’re planning to merge it soon and roll on with our plan to migrate the docs.ansible.com subdomain to Read The Docs.

We want to keep the repo in the ansible-community org. The repo name should be changed to better match the purpose. I would like to ask…

Does ansible-community/docsite sound like a good name?

Do you think ansible-community/ansible-docsite would be better or perhaps something else?

Just thought it’d be nice to ask and give folks a chance to provide some input. @gotmax23 and @mariolenz Do either of you have thoughts on the repo name?

Thanks!

2 Likes