Petr Bokoc kirjoitti 24.5.2021 klo 20.18:
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)
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
Thank you for the advice, Petr. I will make sure to use the latest
template, and to add a pull request to remove the Creating RPM Packages
material from the Quick Docs when they become available in the new location.
Regarding Packaging Guidelines, I was aware that they are under the
Packaging Committee than thus out of scope for me. I am not going to
touch them or related material. Actually, there is one wiki page,
"Policy for encouraging comaintainers of packages", that should probably
be moved to docs.fp.o/packaging-guidelines — I will ask around if the
Packaging Committee considers themselves to own that document.
[1]:
https://fedoraproject.org/wiki/Policy_for_encouraging_comaintainers_of_packages
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
