# How to define docsite for antsibull-docs/sphinx

**URL:** <https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635>\
**Category:** Get Help\
**Tags:** documentation, collections\
**Created:** [April 9, 2025, 5:43pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635 "2025-04-09T17:43:44Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![markfaine](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/markfaine/32/7291_2.png) [@markfaine](https://forum.ansible.com/u/markfaine)\
**Post date:** [April 9, 2025, 5:43pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/1 "2025-04-09T17:43:44Z")

</div>

On this page:

[https://ansible.readthedocs.io/projects/antsibull-docs/collection-docs/](https://ansible.readthedocs.io/projects/antsibull-docs/collection-docs/)

Instructions exist that often refer to `docsite` but never define which of the directories is the docsite. Is it the `built-docs` directory or the `built-docs/rst` directory, or some other directory, perhaps `built-docs/build`?

---

<div class="post-metadata">

**Author:** ![tvo318](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/tvo318/32/3406_2.png) [@tvo318](https://forum.ansible.com/u/tvo318)\
**Post date:** [April 9, 2025, 6:05pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/2 "2025-04-09T18:05:19Z")

</div>

I believe it refers to [ansible-documentation/docs/docsite at devel · ansible/ansible-documentation · GitHub](https://github.com/ansible/ansible-documentation/tree/devel/docs/docsite)

---

<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:** [April 9, 2025, 6:21pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/3 "2025-04-09T18:21:31Z")

</div>

Most of the instances of the use “docsite” on that page refer to the general concept of a docsite. That word is similarly used than “website” or “homepage”. [Ansible Documentation — Ansible Community Documentation](https://docs.ansible.com/ansible/latest/) is a docsite, [https://ansible.fontein.de/](https://ansible.fontein.de/) is a docsite, …

When talking about a directory, it’s usually the `docs/docsite/` directory inside a collection. But then it usually explicitly says `docs/docsite/`.

---

<div class="post-metadata">

**Author:** ![markfaine](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/markfaine/32/7291_2.png) [@markfaine](https://forum.ansible.com/u/markfaine)\
**Post date:** [April 21, 2025, 2:31pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/4 "2025-04-21T14:31:22Z")

</div>

But does it have to be a folder under docs, can it be the docs folder itself? It’s not super clear what folder structure, if any, is required.

---

<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:** [April 21, 2025, 2:55pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/5 "2025-04-21T14:55:43Z")

</div>

What is “it” in your question? The extra docs material must be in `docs/docsite/` (like `config.yml`, `extra-docs.yml`, `links.yml`, and `rst/` for extra documentation source files). Where you place the rendered result or the build scripts for the docsite is up to you. It can be whereever you want in the filesystem.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/ansible/original/1X/1882d9a01da5d8996a862359b0913cc568a39b84.svg) [@system](https://forum.ansible.com/u/system)\
**Post date:** [May 21, 2025, 2:56pm UTC](https://forum.ansible.com/t/how-to-define-docsite-for-antsibull-docs-sphinx/41635/6 "2025-05-21T14:56:11Z")

</div>

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.