[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]


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.



[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

docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx
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/docs@xxxxxxxxxxxxxxxxxxxxxxx

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux