docs January 2020

docs@lists.fedoraproject.org

14 participants
17 discussions

Welcome!
by Petr Bokoc 12 Jan '20

12 Jan '20

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

2 1

Self-Introduction
by Binayak Behera 10 Jan '20

10 Jan '20

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. About Myself I am 3rd-year undergraduate studying in Odisha, India. I am mostly worked in the field of web development. I am proficient in Javascript, Reactjs, Nodejs, and go-lang. Regards Binayak

2 1

Self-Introduction: Newbie to Fedora docs
by rekha kanakaraj 09 Jan '20

09 Jan '20

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) < kanakaraj.rekha(a)gmail.com> sub rsa2048 2020-01-08 [E] Thanks and Regards, Rekha K Raj

1 0

Self-Introduction
by Kevin Becker 08 Jan '20

08 Jan '20

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]

3 4

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by pbokoc＠fedoraproject.org 07 Jan '20

07 Jan '20

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2020-01-08 from 15:30:00 to 16:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar/meeting/9196/

1 0

[Fedocal] Reminder meeting : Docs Writing Hour
by pbokoc＠fedoraproject.org 06 Jan '20

06 Jan '20

Dear all, 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. Source: https://apps.fedoraproject.org/calendar/meeting/9360/

1 0

[Fedocal] Reminder meeting : Fedora Docs Weekly Meeting
by bex＠fedoraproject.org 06 Jan '20

06 Jan '20

Dear all, You are kindly invited to the meeting: Fedora Docs Weekly Meeting on 2020-01-01 from 15:30:00 to 16:00:00 UTC At fedora-meeting(a)irc.freenode.net The meeting will be about: An hour of docs folks talking about what they are working on and what they'd like to work on. More information available at: [https://fedoraproject.org/wiki/Docs_Project_meetings](https://fedoraproject… Source: https://apps.fedoraproject.org/calendar/meeting/9196/

3 2

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs January 2020