# AWX Documentation no longer exists besides contribution guide and API reference?

**URL:** <https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161>\
**Category:** Get Help\
**Tags:** awx\
**Created:** [November 26, 2024, 2:27pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161 "2024-11-26T14:27:00Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![cnfrancis](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/cnfrancis/32/2615_2.png) [@cnfrancis](https://forum.ansible.com/u/cnfrancis)\
**Post date:** [November 26, 2024, 2:27pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/1 "2024-11-26T14:27:00Z")

</div>

hello! is this expected? it used to be accessible now it has been removed?  
perhaps there was an announcement ?  
[https://ansible.readthedocs.io/projects/awx/en/latest/userguide/projects.html](https://ansible.readthedocs.io/projects/awx/en/latest/userguide/projects.html)

 ![image](https://us1.discourse-cdn.com/ansible/original/2X/a/a9046aaa696f795bca75edc9a7999170ba207fe7.png)

---

<div class="post-metadata">

**Author:** ![fs3000](https://avatars.discourse-cdn.com/v4/letter/f/7bcc69/32.png) [@fs3000](https://forum.ansible.com/u/fs3000)\
**Post date:** [November 26, 2024, 2:34pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/2 "2024-11-26T14:34:24Z")

</div>

No new releases on AWX repo on github for a while now. No important bugs being fixed. Lets call this the IBM effect.

---

<div class="post-metadata">

**Author:** ![RoeeFabrikant](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/roeefabrikant/32/5496_2.png) [@RoeeFabrikant](https://forum.ansible.com/u/RoeeFabrikant)\
**Post date:** [November 26, 2024, 3:55pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/3 "2024-11-26T15:55:45Z")

</div>

I was also wondering where the documents disappeared…

---

<div class="post-metadata">

**Author:** ![anon81884396](https://avatars.discourse-cdn.com/v4/letter/a/b782af/32.png) [@anon81884396](https://forum.ansible.com/u/anon81884396)\
**Post date:** [November 26, 2024, 3:55pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/4 "2024-11-26T15:55:47Z")

</div>

[Streamlining AWX Releases](http://forum.ansible.com/t/streamlining-awx-releases/6894) This seems to be what’s going on. I’m sure IBM has some part in it but it also seems like they are focusing on an actual problem they want to solve.

---

<div class="post-metadata">

**Author:** ![RoeeFabrikant](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/roeefabrikant/32/5496_2.png) [@RoeeFabrikant](https://forum.ansible.com/u/RoeeFabrikant)\
**Post date:** [November 26, 2024, 4:00pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/5 "2024-11-26T16:00:19Z")

</div>

@gundalow , Could you help shed some light on this? It’s quite concerning

---

<div class="post-metadata">

**Author:** ![kurokobo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/kurokobo/32/182_2.png) [@kurokobo](https://forum.ansible.com/u/kurokobo)\
**Post date:** [November 26, 2024, 5:26pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/6 "2024-11-26T17:26:10Z")

</div>

This site has been intentionally removed in the following PR with the explanation, “Removed user docs with UI-focus from AWX as part of the AWX modernization efforts.”

> <https://github.com/ansible/awx/pull/15641>
>
> \##### SUMMARY
> Removed user docs with UI-focus from AWX as part of the AWX moder…nization efforts. 
> 
> \##### ISSUE TYPE
> - Bug, Docs Fix or other nominal change
> 
> \##### COMPONENT NAME
> - Docs
> 
> \##### AWX VERSION
> latest

On the other hand, this is a page for the latest version where the ongoing changes in development are always reflected, so the versioned latest documentation can be checked at the following URL

[https://ansible.readthedocs.io/projects/awx/en/24.6.1/userguide/index.html](https://ansible.readthedocs.io/projects/awx/en/24.6.1/userguide/index.html)

I understand that the AWX UI is expected to change significantly, but I hope that sufficient user documentation, similar to the deleted documents, will be released when the new AWX is launched.

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [November 26, 2024, 6:09pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/7 "2024-11-26T18:09:16Z")

</div>

Hi folks,  
I know the 404 page is concerning (I’ll see if we can improve that)  
We now have versioned docs

So the page is now

[https://ansible.readthedocs.io/projects/awx/en/24.6.1/userguide/projects.html](https://ansible.readthedocs.io/projects/awx/en/24.6.1/userguide/projects.html)

Notice the `/24.6.1/` (instead of `/latest/`) in the URL

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [November 26, 2024, 6:31pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/8 "2024-11-26T18:31:04Z")

</div>

I’m sorry that I missed this when we resumed publish the AWX docs.

~~Looks like ReadTheDocs (which we use for our upstream docs) does support custom 404 pages, I’ve raised an issue to get this sorted. I’ll work with Engineering to get this prioritized, we might be able to setup some redirects. I’m not sure how I missed this, so thank you for pinging me directly on this issue.~~ [PR in flight](https://github.com/ansible/awx/pull/15668)

For context, we moved to [Read The Docs for AWX](https://github.com/ansible/awx/pull/14328) about a year ago

For more context on the rearchitecture, please take a look at this forum posts. There are real problems with how AWX has grown over the past decade, and we at Red Hat are investing a lot of time to improve the architecture

These links go into more details about the re-architecture work:

- [Streamlining AWX Releases](http://forum.ansible.com/t/streamlining-awx-releases/6894)
- [Refactoring AWX into a Pluggable, Service-Oriented Architecture](http://forum.ansible.com/t/refactoring-awx-into-a-pluggable-service-oriented-architecture/7404)
- [Upcoming changes to AWX Operator installation methods](http://forum.ansible.com/t/upcoming-changes-to-awx-operator-installation-methods/7598)
- [AWX UI and credential types transitioning to the new pluggable architecture](http://forum.ansible.com/t/awx-ui-and-credential-types-transitioning-to-the-new-pluggable-architecture/8027)

---

<div class="post-metadata">

**Author:** ![cnfrancis](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/cnfrancis/32/2615_2.png) [@cnfrancis](https://forum.ansible.com/u/cnfrancis)\
**Post date:** [November 26, 2024, 9:27pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/10 "2024-11-26T21:27:42Z")

</div>

Awesome, thank you for confirming @gundalow! That’s great that we have versioned documentation. I guess google is indexing first the latest doc since it receives most of the clicks.

\*Apologies if the tone sounded adversarial, not my intention at all

---

<div class="post-metadata">

**Author:** ![cnfrancis](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/cnfrancis/32/2615_2.png) [@cnfrancis](https://forum.ansible.com/u/cnfrancis)\
**Post date:** [November 27, 2024, 7:28pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/12 "2024-11-27T19:28:40Z")

</div>

> [@gundalow](#):
>
> [16. Projects — Ansible AWX community documentation](https://ansible.readthedocs.io/projects/awx/en/24.6.1/userguide/projects.html)

Use this link: [Ansible AWX Documentation — Ansible AWX community documentation](https://ansible.readthedocs.io/projects/awx/en/24.6.1/)  
and you can specify the version

` https://ansible.readthedocs.io/projects/awx/en/<versions>/`

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [December 4, 2024, 4:58pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/13 "2024-12-04T16:58:53Z")

</div>

Hi folks  
We believe this is fix.

If you see any issues please let us know.

---

<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:** [January 3, 2025, 4:59pm UTC](https://forum.ansible.com/t/awx-documentation-no-longer-exists-besides-contribution-guide-and-api-reference/11161/14 "2025-01-03T16:59:44Z")

</div>

Closed on January 3, 2025, 4:59pm UTC

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