Package Maintainer Docs publishing

Otto Urpelainen <[email protected]> Thu, 15 Jul 2021 09:07:48 +0300
Newsgroups gmane.linux.redhat.fedora.documentation
Message-ID <[email protected]>
Petr Bokoc kirjoitti 24.5.2021 klo 20.12:
> 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.

Package Maintainer Docs are now in publishable state. I made these two 
pull requests that should make it happen:

https://pagure.io/fedora-docs/docs-fp-o/pull-request/171#
https://pagure.io/fedora-docs/pages/pull-request/14

> 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 -- [email protected]
>> To unsubscribe send an email to [email protected]
>> 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/[email protected]
>> Do not reply to spam on the list, report it:
>> https://pagure.io/fedora-infrastructure
> 
> 
> _______________________________________________
> docs mailing list -- [email protected]
> To unsubscribe send an email to [email protected]
> 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/[email protected]
> Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure
> 
_______________________________________________
docs mailing list -- [email protected]
To unsubscribe send an email to [email protected]
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/[email protected]
Do not reply to spam on the list, report it: https://pagure.io/fedora-infrastructure