Re: Fwd: Application to contribute as a technical writer

On 1/28/19 7:20 PM, Nick Bebout wrote: Hi Ed, welcome to Fedora Docs! If you want to contribute, the first thing you'll need is a Fedora Account System (FAS) account.[0] Registering there will give you access to a bunch of other systems, like commenting on issues in our source repositories or the forums.[6] All of our docs are written in the ASCIIDoc markup language[1], the sources are stored in Git repositories on Pagure[2], they're built using the Antora site generator[3] and published on the docs site[4]. It's not necessary to understand all of that though, you can contribute even if you don't know ASCIIDoc, Git, Antora or anything else - although it does help. Are you familiar at least with Git? That's usually the biggest hurdle, everything else is pretty straightforward. There's an excellent free ebook[7] on it to get you started if you've never used it, and if you google a bit there are some interactive tutorials available online. Also is there anything specific on our docs site you're interested in working on, any area of interest? As for communication, we use this mailing list and also the #fedora-docs channel on IRC on FreeNode.[5] You can also access that channel through Telegram if you prefer; there's a bot that bridges Telegram with the IRC channel - join the group "Fedora Docs". I'm in the same timezone you are and I'm usually available throughout the day and sometimes evenings (especially during weekdays), my nick is the same as my e-mail username, so ping me if you have questions. Cheers, Petr [0] Register here: https://admin.fedoraproject.org/accounts/ [1] https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/ [2] https://pagure.io/projects/fedora-docs/%2A [3] https://docs.antora.org/antora/2.0/ [4] https://docs.fedoraproject.org/en-US/docs/ [5] https://freenode.net/kb/answer/chat [6] https://discussion.fedoraproject.org/ [7] https://git-scm.com/book/en/v2