Hi! I'm Justin. Ben Cotton hosted a Fedora "birds of a feather" event at Ohio Linux Fest this past weekend, and we talked docs. I'd like to help.
I started my career as a technical writer. (I took over Klaatu's job, if any of you know him!) Later, I became a Linux system administrator. (Got my RHCSA and RHCE. I'm a big fan of Ansible; I'm going to start publishing roles I've made.) Now, I'm transitioning to DevOps mainly through work with Python and GitLab.
But I still love to write. Where I work, I've developed our IT documentation strategy. I write OpsDocs for (nearly) all servers and technologies that we use as well as runbooks for IT support. I'm kind of infamous for wanting everything documented.
I practically live in Emacs Org Mode and have used Markdown and some RST. I haven't used AsciiDoc yet, but I should be a quick study. If someone could mentor me as I get started, that'd be great.
I'm happy to help where the need is greatest, but Ben mentioned that the package building instructions need moved from the wiki to the docs site. That might be interesting. I'd like to get better at RPM packaging for my own reasons.
GPG info:
pub rsa4096 2019-11-04 [SC] 87EB 9C69 CFB1 9653 17B4 F2F1 CF72 BA34 68F4 26F3 uid [ultimate] Justin Smith (Signing) justin@adminix.net
Hi Justin,
Welcome to the team! The wiki pages in mentioned in the BoF are: * https://fedoraproject.org/wiki/New_package_process_for_existing_contributors * https://fedoraproject.org/wiki/Package_Review_Process * https://fedoraproject.org/wiki/Join_the_package_collection_maintainers
The Packaging Guidelines (https://docs.fedoraproject.org/en-US/packaging-guidelines/) are already moved out of the wiki, but I'm not sure if the wiki pages above belong with them or elsewhere. I can see the case for them being a part of the Quick Docs, perhaps alongside https://docs.fedoraproject.org/en-US/quick-docs/creating-rpm-packages/ or if they belong elsewhere.
We don't have a good place for lengthier docs focused on contributors at this point, IMO. That might be a broader question for us to answer at some point. I'll let others on the list offer their opinions about this.
docs@lists.stg.fedoraproject.org