# Redirecting index pages in the package docs nav

**URL:** <https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797>\
**Category:** Project Discussions\
**Tags:** documentation\
**Created:** [October 19, 2023, 10:29am UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797 "2023-10-19T10:29:50Z")\
**Posts on this page:** 7\
**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:** [October 19, 2023, 10:29am UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/1 "2023-10-19T10:29:50Z")

</div>

Hi all,

We’re relocating the Getting Started with Execution Environments content from the package docs to a new ecosystem docsite [1] [2]. As part of this I’m setting up http redirects so that urls such as `https://docs.ansible.com/ansible/devel/getting_started_ee/index.html` take you to `https://ansible.readthedocs.io/en/latest/getting_started_ee/index.html`.

This is probably sensible for sub-pages but I wonder if it is best practice for the index page. We want to keep “Getting started with EEs” in the left nav of the package docs. But would it be confusing or unexpected if someone clicks an item in the left nav then gets redirected to a different site?

Thoughts are welcome here or in the PR with redirects[3].

[1] [Point EE getting started to ecosystem by oraNod · Pull Request #617 · ansible/ansible-documentation · GitHub](https://github.com/ansible/ansible-documentation/pull/617)  
[2] [index - Ansible ecosystem documentation](https://ansible.readthedocs.io/en/latest/getting_started_ee/index.html)  
[3] [redirect ee getting started docs by oraNod · Pull Request #187 · ansible/docsite · GitHub](https://github.com/ansible/docsite/pull/187)

---

<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:** [October 19, 2023, 1:11pm UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/2 "2023-10-19T13:11:05Z")

</div>

My thought was we would not redirect the EE getting started index page. We’d leave that as a stub page that introduces what an EE is and then point to the ecosystem docsite for that guide.

I think this sets us up with findability (we have small intros to any ecosystem docset on our main Ansible docs) without too much clutter on the main Ansible package docs.

---

<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:** [October 23, 2023, 4:50pm UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/3 "2023-10-23T16:50:37Z")

</div>

Thanks @samccann I’ve removed the redirect for the index page from [redirect ee getting started docs by oraNod · Pull Request #187 · ansible/docsite · GitHub](https://github.com/ansible/docsite/pull/187)

---

<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:** [October 25, 2023, 10:18am UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/4 "2023-10-25T10:18:33Z")

</div>

@Andersson007 Hey, heads up that I’ll merge [Point EE getting started to ecosystem by oraNod · Pull Request #617 · ansible/ansible-documentation · GitHub](https://github.com/ansible/ansible-documentation/pull/617) later today. Just thought I’d ping you again as a final heads up.

As mentioned above I’ve also updated the redirects PR so the index page doesn’t take you to the ecosystem docsite.

@samccann had a good point yesterday in the DaWGs about links to the EE getting started in the package docs so I’m going to go through the logs and adjust all those in a PR later today too. e.g. hhttps://github.com/ansible/ansible-documentation/commit/e6f4c0eb50ad60715fd367241c29a3fabc5d5956

---

<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:** [October 25, 2023, 2:47pm UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/5 "2023-10-25T14:47:09Z")

</div>

Thanks for handling the package docs references. @Andersson007 also updated other projects with links back to the EE getting started. Perhaps he remembers which other projects need updating too? We could always open them as a batch of easyfix items to get community help with cleaning up the rest.

---

<div class="post-metadata">

**Author:** ![Andersson007](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/andersson007/32/89_2.png) [@Andersson007](https://forum.ansible.com/u/Andersson007)\
**Post date:** [October 26, 2023, 7:36am UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/6 "2023-10-26T07:36:35Z")

</div>

@samccann the plan about easyfixes SGTM, here’s a list of places where it can be fixed:

- AWX: [docs/execution\_environments.md: add a link to EE getting started guide by Andersson007 · Pull Request #14263 · ansible/awx · GitHub](https://github.com/ansible/awx/pull/14263)
- Builder: [[Docs] docs/index.rst: replace EE overview paragraph with a link to docs.ansible.com EE page by Andersson007 · Pull Request #580 · ansible/ansible-builder · GitHub](https://github.com/ansible/ansible-builder/pull/580)
- Navigator: [Add EE Getting started references to docs by Andersson007 · Pull Request #1576 · ansible/ansible-navigator · GitHub](https://github.com/ansible/ansible-navigator/pull/1576)
- Runner: [docs/execution\_environment.rst: add a note with reference to Getting started EE guide by Andersson007 · Pull Request #1301 · ansible/ansible-runner · GitHub](https://github.com/ansible/ansible-runner/pull/1301)

---

<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:** [November 28, 2023, 9:31pm UTC](https://forum.ansible.com/t/redirecting-index-pages-in-the-package-docs-nav/1797/7 "2023-11-28T21:31:03Z")

</div>

Finally opened the easyfix issues for these.  
@Dule-martins - I added them to the community-writers board but you’ll want to check each one for the contributor guidelines. They are all different repos so may require things like commit signing etc.
