# A new look for docs.ansible.com

**URL:** <https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437>\
**Category:** Project Discussions\
**Tags:** aap, dawgs-meeting\
**Created:** [September 8, 2025, 1:52pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437 "2025-09-08T13:52:59Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [September 8, 2025, 1:52pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437/1 "2025-09-08T13:52:59Z")

</div>

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](https://forum.ansible.com/t/we-re-moving-to-read-the-docs/43519/7), 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](https://github.com/ansible-community/community-website/pull/475)

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/](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](https://matrix.to/#/#docs:ansible.com)

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [September 9, 2025, 3:53pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437/2 "2025-09-09T15:53:03Z")

</div>

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](http://docs.ansible.com) front pages 🙂

---

<div class="post-metadata">

**Author:** ![felixfontein](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/felixfontein/32/7530_2.png) [@felixfontein](https://forum.ansible.com/u/felixfontein)\
**Post date:** [September 10, 2025, 6:55pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437/3 "2025-09-10T18:55:00Z")

</div>

[https://ansible-community-website--475.org.readthedocs.build/](https://ansible-community-website--475.org.readthedocs.build/) looks great!

---

<div class="post-metadata">

**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\
**Post date:** [September 18, 2025, 1:43pm UTC](https://forum.ansible.com/t/a-new-look-for-docs-ansible-com/44437/4 "2025-09-18T13:43:51Z")

</div>

@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!
