Hi David, all Just want to give my perspective on this issue [1]
I acknowledge that docs are an essential resource for Pulp users. As someone who wrote tech docs for nine years, I get the importance of findable docs. However, one thing that struck me was that the former Documentation link on the navbar didn't bring the user to docs, but to a page with a set of versioned docs[2], and from there the user had to click for the docs site. On the home page of the docs site, the user would have to click a few more times to get to where they wanted to go. As a user, especially a new user, that is quite a few clicks. When I look at the home page, there are links to Pulp 2 or 3 installation docs, which are clearly labeled, and accessible in one click. When you click the Plugins heading, you're presented with a list of docs per plugin. One click and you're in there too. I quite like the focused user paths on the Foreman site [3]. Again there is immediate access to docs on the front page, but no 'docs' link. If community members do not like that approach, we will need to have a discussion about the best way to guide users through our content. I would be happy to leave the issue open, or to assign it to me, for a few weeks until I put more shape to new pages. TL;DR In my opinion, the surviving links on the Pulp site direct users to key scenarios in fewer clicks. I am working on building out more content with clearer user paths. [1] https://pulp.plan.io/issues/6687 [2] https://pulpproject.org/docs/ [3] https://theforeman.org/ -- Melanie Corr, RHCE Community Manager Red Hat <https://www.redhat.com> Remote, Ireland mc...@redhat.com M: +353857774436 IM: mcorr <https://www.redhat.com>
_______________________________________________ Pulp-dev mailing list Pulp-dev@redhat.com https://www.redhat.com/mailman/listinfo/pulp-dev
