Self Introduction: Otto Urpelainen

[Otto Urpelainen]

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

[Petr Bokoc]

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

[Petr Bokoc]

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

[Otto Urpelainen]

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_packa...
> > 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

Package Maintainer Docs publishing

[Otto Urpelainen]

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