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
* 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
and our contributor docs.
* 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), 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.
* 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.
Greetings Fedora Documentation List
I have just subscribed to the mailing list and really interested to contribute to the Fedora Docs project. I have no prior experience in open source contribution. I keen to start my contributions to fedora docs and hope my contributions will improve the fedora docs. Being an open-source enthusiast, I will continue to contribute continuously.
Hi Everyone, My name is Rekha and I have just signed up for this mailing
list, hoping to make some useful contributions to the Fedora docs project.
Country of residence is India.
I am a civil engineer with ~10 years of experience in the construction
industry/Government projects/ Structural designing and CAD. Currently I am
on a sabbatical, taking care of my twin boys. I wish to take up some work
in my free time which can be done remotely and since I am not into coding,
I thought of trying technical documentation. I also have a small experience
working with Oracle DB and done some C programming prior to joining the
construction industry. Recently I did some basic training in html/xml/css.
I can work with software tools/scripts(git/gerrit), albeit not much into
coding or software design now. This is my first attempt at contributing to
an open source project. I am hoping I could spare 7-10 hours a week.
My motivation to join an opensource project is my husband, who is a
developer by profession and contributes to Github projects.
I read through some part of the 'Beats' section, if you guys can suggest
some work for a newbie that would be helpful. I can go through
links/pointers as per suggestions and come back on this list for help.
My GPG info is below:
Inspiron-5370:~$ gpg --fingerprint F8237B88
pub rsa2048 2020-01-08 [SC]
B6D9 38C3 AD36 16D5 50CA 0C2B 9AAD 130E F823 7B88
uid [ultimate] Rekha K Raj (Technical Writer) <
sub rsa2048 2020-01-08 [E]
Thanks and Regards,
Rekha K Raj
Hello everyone, I just signed up for the mailing list and am interesting in contributing to the Fedora Docs project. I have not contributed to any open source projects in the past (apart from a tiny pull request that was accepted to systemd). I’ve written internal technical documentation for my job in the past and I occasionally write technical articles on topics of interest to me on my blog at http://kevinbecker.org <http://kevinbecker.org/> but that’s about it.
I’m a network/system admin at a midsized company currently. I’ve worked in IT for the past 25 years or so and have experience with everything from NetWare in the old days, through most flavors of Windows, RHEL, and even macOS. I’ve used linux on and off since the mid 90s, starting out with Slackware, before moving on to Red Hat. I moved away from Linux on the desktop when OS X started to get usable in the early 2000s but over the past few years, after a little bit of distro hopping, I’ve moved back to Fedora as my primary desktop OS for personal use.
I’ve done a lot of scripting but very little “real” coding. I’ve considered getting into package maintenance, as I did Windows packaging for many years, but haven’t made the time to dig into it yet, so in the mean time I hoped that I might be able to give back to the community a bit by helping out with documentation.
My GPG info is below:
kevin@artoo:~$ gpg --fingerprint BB7D7B77
pub rsa4096 2019-08-14 [SC] [expires: 2023-08-14]
0FF6 9B9A B6CC E25E 375B 8437 9445 90E5 BB7D 7B77
uid [ultimate] Kevin Becker <kevin(a)kevinbecker.org>
sub rsa4096 2019-08-14 [E] [expires: 2023-08-14]
You are kindly invited to the meeting:
Docs Writing Hour on 2020-01-08 from 10:00:00 to 11:00:00 US/Eastern
The meeting will be about:
Join members of the docs team in #fedora-docs for writing time. This is a great time to focus on writing and talk about challenges and blockers related to producing content.
There is no formal schedule for this meeting. Attendees should show up and use this as a way to block writing time into their week.