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

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

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

I was also wondering where the documents disappeared…

Streamlining AWX Releases 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.

1 Like

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

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.ā€

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

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.

3 Likes

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

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

2 Likes

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

For context, we moved to Read The Docs for AWX 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:

2 Likes

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

1 Like

Use this link: Ansible AWX Documentation — Ansible AWX community documentation
and you can specify the version

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

Hi folks
We believe this is fix.

If you see any issues please let us know.

1 Like

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