ansible / ansible-documentation

Ansible community documentation
https://docs.ansible.com/
GNU General Public License v3.0
84 stars 500 forks source link

Coordinate ecosystem docsites to include link back to docs.ansible.com #877

Open samccann opened 11 months ago

samccann commented 11 months ago

All projects on this page should include a link back to docs.ansible.com

webknjaz commented 11 months ago

All projects on this page should include a link back to docs.ansible.com

Oh, I noticed that the ansible-pylibssh project is spelled weirdly (with a whitespace and capitalization!). Haven't found where to fix that.

As for the backlinks, updating the base Sphinx theme footer could address this. Alternatively, said projects would probably have to inherit the upstream footer and make a small tweak.

samccann commented 11 months ago

@webknjaz - @oraNod is in the middle of having that page redirected to https://ansible.readthedocs.io/en/latest/ecosystem.html so if you follow the github link, you can likely find the source.

So only 1/2 the projects use the sphinx theme, but that does sound like a promising approach. Though I'm unsure we want a link back in the footer vs the header.

gotmax23 commented 11 months ago

I opened https://github.com/ansible/mkdocs-ansible/issues/74 for the mkdocs theme.

oraNod commented 11 months ago

All projects on this page should include a link back to docs.ansible.com

Oh, I noticed that the ansible-pylibssh project is spelled weirdly (with a whitespace and capitalization!). Haven't found where to fix that.

@webknjaz https://github.com/ansible/docsite/blob/0fd7e268e947c0fab26f6df515c82e2f755f3ee1/data/ecosystem.yaml#L88

samccann commented 10 months ago

Looking at the latest ansible sphinx theme, it already includes a link to docs.ansible.com image

So when projects upgrade, they'll get that fix.