Re: User Documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, Dec 7, 2021 at 4:16 AM Kevin Fenzi <kevin@xxxxxxxxx> wrote:
>
> On Mon, Dec 06, 2021 at 05:39:19PM +1000, Ryan Lerch wrote:
> > Good Morning!
> >
> > Just wondering if anyone has any thoughts on where we could place User
> > Documentation for websites and tools that fedora-infra owns.
> >
> > During the development of Noggin / Fedora Accounts, we created user
> > documentation for Fedora Accounts, and sort of just threw it up on the
> > Fedora Docs site:
> >
> > https://docs.fedoraproject.org/en-US/fedora-accounts/
> >
> > it is linked in the main docs structure in a weird way too: from the
> > main docs.fp.o index, click on engineering teams, then at the bottom
> > of that list on this page:
> > https://docs.fedoraproject.org/en-US/engineering/ we have the Fedora
> > Accounts Docs.
> >
> > I have been working on a few drafts and outlines of user-facing
> > documents, but just wondering if anyone has any ideas on where to
> > present them.
> >
> > Was thinking having a sub-sub group on the new gitlab instance to
> > store the source, and possibling creating a new subsection on Fedora
> > Docs to link to the list of docs.
> >
> > thoughts?
>
> Good question(s). :)
>
> I wonder if we should ask for a top level section under 'User
> Documentation' and call it something like 'Fedora Infrastructure
> applications' ?

+1

I will get this implemented today.

cheers,
ryanlerch
>
> This was one big annoyance with the wiki... we had user docs mixed with
> contributor docs, mixed with other. It would be great to clearly mark
> user docs as such and target them accordingly.
>
> As for where they live, I'd leave that up to who is doing them, but all
> the rest of the docs are on pagure, so IMHO it would make sense for them
> to be there also, unless we want to move all the docs over to gitlab
> (which of course would require buyin from docs folks. :)
>
> kevin
> _______________________________________________
> infrastructure mailing list -- infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
> To unsubscribe send an email to infrastructure-leave@xxxxxxxxxxxxxxxxxxxxxxx
> Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
> List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
> List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
> Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
_______________________________________________
infrastructure mailing list -- infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to infrastructure-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/infrastructure@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure




[Index of Archives]     [Fedora Development]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Yosemite News]     [KDE Users]

  Powered by Linux