Oh, I forgot: There are some packaging docs that are already being
published; most importantly the Packaging Guidelines[0], but we also
have a few bits in Quick-docs[1]. The Packaging Guidelines should stay
where they are, since there's a whole team working on those and I'd like
to avoid disrupting them, but I'm fine with moving [1] from Quick-docs
to dedicated maintainer documentation. Let's make sure to avoid
duplicating information.
Petr
[0]
(and check the table of contents on the left, there are 2 more pages)
On 5/24/21 7:12 PM, Petr Bokoc wrote:
Hello Otto, welcome to Fedora Docs!
I'm happy to hear you want to take over the Package Maintainer docs.
Your plan is good, that's the best way I can see it happening.
Also, I just pushed an update to the template repo, so if you haven't
started yet, please make sure to pull before you begin the conversion.
If you already got some work done, it's no big issue, the old template
still works, and if you want to update your docs too, the only
important change is that partial files are now in
modules/<module_name>/partials and they should be included as
"include::partial$filename.adoc[]". The docs on that are here:
https://docs.antora.org/antora/3.0/partials-directory/
Other than that, let me know here or on IRC/Telegram/Matrix (pbokoc in
#fedora-docs) if you need anything. Once you have a repo that's in a
publishable state - it doesn't have to be a complete wiki conversion,
just something you're comfortable with putting up on the internet, let
me know and I'll make sure it appears on our docs site.
Cheers,
Petr
On 5/23/21 7:28 PM, Otto Urpelainen wrote:
> Greetings,
>
> I have been using Fedora since 2013 and started contributing in the
> beginning of 2021 by adopting some orphaned packages, doing package
> reviews and submitting patches for various tools.
>
> I recently volunteered to move Fedora Package Maintainer docs from
> the old wiki system [1] to
docs.fedoraproject.org. Supposedly, I will
> also be involved in maintaining the new system afterwards. Thus I
> decided to join the docs mailing list, too.
>
> My plan for Package Maintainer docs migration is to first reset the
> old, unfinished attempt at
> pagure.io/fedora-docs/package-maintainer-docs to use the
> fedora-docs/template, then convert existing material on the wiki with
> pandoc. If anybody knows a better way, please let me know.
>
> Otto Urpelainen
>
> [1]:
https://fedoraproject.org/wiki/Category:Package_Maintainers
> _______________________________________________
> docs mailing list -- docs(a)lists.fedoraproject.org
> To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org
> 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/docs@lists.fedoraproject.org
> Do not reply to spam on the list, report it:
>
https://pagure.io/fedora-infrastructure
_______________________________________________
docs mailing list -- docs(a)lists.fedoraproject.org
To unsubscribe send an email to docs-leave(a)lists.fedoraproject.org
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/docs@lists.fedoraproject.org
Do not reply to spam on the list, report it:
https://pagure.io/fedora-infrastructure
--
Petr Bokoč
Senior Technical Writer, Fedora/CentOS
Red Hat Czech, s. r. o. <