[Fedora-packaging] Re: Updating one-off contributions documentation

[Vít Ondruch]

Just looking at the Docs page, the most suitable place seems to be:

https://docs.fedoraproject.org/en-US/project/join/

However, if there was completely separate top level section such as "How 
to contribute" > "Packaging" > "Joint the package collection 
maintainers", I think this would give use also place for e.g. 
"Package_Review_Process" which would be next natural candidate for move 
from wiki.


Vít


Dne 15. 02. 21 v 20:24 Otto Urpelainen napsal(a):
>  Vít Ondruch kirjoitti 15.2.2021 klo 11.21:
> >
> > Dne 13. 02. 21 v 8:47 Otto Urpelainen napsal(a):
> >> Hi,
> >>
> >> I would like to update the instructions for [One-off contributions][1]
> >> to packages. First, they are outdated, there is no need for external 
> >> Git
> >> hosting since the anonymous checkout from src.fp.o method can now be
> >> used.
> >
> > I think the anonymous checkouts are enabled for ages, but the problem 
> > is that without Fedora account with correct privileges, you cannot 
> > create the PR on src.fedoraproject.org.
>
>  Perhaps the set of required privileges has been relaxed recently, then.
>  Currently, the anonymous checkout method requires only creating a Fedora
>  account and maybe some configuration that you can do yourself. That is
>  how I started contributing to Fedora, and it worked.
>
> >> Currently, the documnetation is in the wiki. Am I correct that this 
> >> kind
> >> of content should go to docs.fp.o? If so, I can make a pull request to
> >> move it. Either the whole _Joint he package collection maintainers_
> >> page, or just the one-off contributions section. Does anybody here know
> >> what would be the correct course of action?
> >
> > If you open any documentation page, there is a link to "Want to help? 
> > Learn how to contribute to Fedora Docs." at the bottom. From there, 
> > you could get to:
> >
> > https://docs.fedoraproject.org/en-US/fedora-docs/contributing/adding-new-... 
>
>
>  [Contributing to existing docs][1] would be more relevant, because the
>  content would fit well to [Quick Docs][2] that already has packaging
>  related articles.
>
>  However, that is beside the point. The reason why I ask here is that I
>  am unsure what is the correct location for this material. Both docs and
>  wiki have similar material. Wiki has more, but on the other hand wiki
>  declares right on the front page that is [not for documentation][3].
>
>  [1]: 
>
> https://docs.fedoraproject.org/en-US/fedora-docs/contributing/contributin...
>  [2]: https://docs.fedoraproject.org/en-US/quick-docs/
>  [3]: https://fedoraproject.org/wiki/Fedora_Project_Wiki#This_Wiki
>
> >> Docs would be a better location for the one-off contributions 
> >> section in
> >> particular. If anyone needs that information, they likely do not have
> >> the required groups in the Fedora Accounts to update the wiki. In case
> >> they discover anything is wrong or missing. With docs, that is not a
> >> problem, since the pull request method works there.
> >
> > Not sure if the idea was not that wiki is easier for adjustments, 
> > because if nothing else, you don't need anybody to approve the PR.
>
>  Yes, it is easier to update the wiki than the docs since the
>  fork-clone-commit-push-PR-review mechanism is not involved. But like I
>  already said above: "If anyone needs that information, they likely do
>  not have the required groups in the Fedora Accounts to update the wiki."
>  This was also my situation when I stated this thread, though I have been
>  added to a suitable group since then.
>
>  I think I will just update the existing wiki page. The wiki or docs
>  question seems muddy, so I think it is best to simply update the
>  content where is resides now.