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] https://docs.fedoraproject.org/en-US/packaging-guidelines/
[1]
https://docs.fedoraproject.org/en-US/quick-docs/creating-rpm-packages/
(and check the table of contents on the left, there are 2 more
pages)
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@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-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/docs@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
_______________________________________________ docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to docs-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/docs@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
_______________________________________________ docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to docs-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/docs@xxxxxxxxxxxxxxxxxxxxxxx Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
