On 1/28/19 7:20 PM, Nick Bebout wrote:


---------- Forwarded message ---------
From: Ed Sherrington <sherringtoned@gmail.com>
Date: Fri, Jan 25, 2019 at 3:47 AM
Subject: Application to contribute as a technical writer
To: <docs-owner@lists.fedoraproject.org>


Hello,

My name is Ed Sherrington, I am a writer looking to get more experience in technical writing. Currently I work for a large company doing web based writing and editing for landing pages, static pages etc. as well as blog articles. I have experience using a bit of html coding but currently we are focusing on transferring content onto a new platform - Typo3.

I'm pretty computer literate but by no means a coder, though I do understand its fundamentals.

As mentioned, writing would be my best skill set, I have a degree in literature, a diploma in journalism and have worked in digital marketing and SEO. Therefore I also understand the analytical side of it.

I think I'd be great for this project as I'm eager to learn and currently have time to do so. I really want to break into technical writing professionally and so I'd like to take in as much as possible and make my work for you shine.

I'm afraid I'm at work currently so can't download any applications for the GPG key, I can re-send this tomorrow after trying from home if that works?

I'm in Berlin, Germany. Other than technical writing I'm not sure what else I'd be interested in.

Best,

Ed Sherrington


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