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.