[Pulp-dev] Issue #6687

[David Davis]

Melanie,

That sounds like a good plan to me. I'll be interested to see what you come
up with.

I filed the issue in the wrong place and should have filed it against the
pulpproject.org github repo. So I'd propose we close it out.

David


On Mon, May 11, 2020 at 8:15 AM Melanie Corr <mcorr at redhat.com> wrote:

> 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
>
> mcorr at redhat.com
> M: +353857774436     IM: mcorr
> <https://www.redhat.com>
>
> _______________________________________________
> Pulp-dev mailing list
> Pulp-dev at redhat.com
> https://www.redhat.com/mailman/listinfo/pulp-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/pulp-dev/attachments/20200512/61ebd0fc/attachment.htm>