Hi everyone,
We've seen several introductions on the list in the last few days, so I
thought I'd welcome everyone in one mail instead of replying to each
introduction separately. Welcome to Fedora Docs, Kevin, Binayak, and Rekha!
Here's a quick rundown of how the project works:
* The Fedora Docs Project maintains the docs site at
https://docs.fedoraproject.org/ as a whole, and we directly maintain
docs listed in "Fedora <x>" and "Quick Docs" under "User
Documentation".
There are other docs on the site as well, but those are generally
maintained by others, e.g. various special interest groups or the Fedora
project leadership.
* You can go ahead and contribute to any of these repositories, but keep
in mind that I can generally only merge your pull requests for things
directly maintained by the Docs Project; acceptance of your
contributions to other stuff depends on the people who maintain each
particular set of docs. They're generally open to contributions, but it
might take them a long time to accept them, or you might accidentally
edit something they were planning to rewrite anyway, so your work might
end up wasted. It's probably best to ask the maintainers first before
contributing; you can find someone to contact in each Pagure repository.
* Pagure repos are where the sources are stored, and there are a lot of
them. You can however find the source repo for each page very easily by
clicking "Edit this page" in the top right corner of any page (other
than the splash page at docs.fp.o and its subpages) - that will take you
right to the repository from which that page was built. (Actually a
couple of the source repos we publish are on GitHub, but the link works
in that case, too.)
* For instructions on how to contribute, see Ben's recent Git writeup[0]
and our contributor docs[1].
* One specific area where we always need help and that is also good for
newcomers to gets started is quick-docs. You can contribute by either
going through the pages we already publish and reviewing them for
accuracy (see the "Reviewers needed!" section in the README[2]), or you
can work on fixing the remaining pages in the repository that are still
not properly converted (quick-docs started out as a list of the most
viewed articles in the Wiki that we decided to get out of there and
convert into proper docs, but the repository still contains some that
are not publishable because the automatic conversion wasn't all that
great). Instructions for that are under the "Steps" section on the quick
docs front page[3].
* Apart from that you can go ahead and check open issues in various
repositories, pick one that interests you and work on fixing it.
* Finally, one thing we periodically need help with is writing release
notes for the next release. However, right now it's too early to do
that, Fedora 32 hasn't even been branched yet, so we can't start now,
the release notes season starts after the release enters beta state.
I'll send an announcement mail with instructions when that happens, but
in the meantime, let's focus on other work.
Hope that clears things up for everyone. If you have any questions, go
ahead and ask, either here on the list or on IRC/Telegram.
Cheers,
Petr
[0]
https://fedoraproject.org/wiki/User:Bcotton/git-for-docs-writers
[1]
https://docs.fedoraproject.org/en-US/fedora-docs/contributing/
[2]
https://pagure.io/fedora-docs/quick-docs
[3]
https://docs.fedoraproject.org/en-US/quick-docs/#_steps