Hey Ben, On 12/16/19 4:04 PM, Ben Cotton wrote: > Hi docs team, > > In response to a few conversations I've had with folks, I put together a > basic guide to git for docs writers: > > https://fedoraproject.org/wiki/User:Bcotton/git-for-docs-writers > This is useful. An opinionated way of doing things helps. It would be awesome to integrate this into the Fedora Docs contributor guidelines. > I appreciate your feedback, bearing in mind that I intentionally wrote > this to be a single way of doing things to focus on getting the job done > instead of teaching the reader all of the different ways to do a task. > To make this more effective and improve its reach, consider assuming the reader uses any of a range of operating systems. It might help to offer pointers for macOS, Windows, maybe DEB/APT users. I am thinking of my experience in Fedora's Telegram, Reddit, and Discord, where community members were frequently interested in improving or enhancing docs when gently prompted. Often times, people may use Fedora in a project-specific or at their work, but their private, personal machine (where they contribute from) is not Fedora. > If it's useful, I'm happy to asciidoc it and put it somewhere (I'm just > not sure where). > I think the most-visible place for people wanting to contribute to Fedora Docs is here: https://docs.fedoraproject.org/en-US/fedora-docs/contributing/ So maybe this is a good place to start? https://pagure.io/fedora-docs/documentation-contributors-guide/blob/master/f/modules/contributing/pages/index.adoc -- Cheers, Justin W. Flory justinwflory.com TZ=America/New_York Pronouns: he/him/his
Attachment:
signature.asc
Description: OpenPGP digital signature
_______________________________________________ docs mailing list -- docs@xxxxxxxxxxxxxxxxxxxxxxx To unsubscribe send an email to docs-leave@xxxxxxxxxxxxxxxxxxxxxxx Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/ List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines List Archives: https://lists.fedoraproject.org/archives/list/docs@xxxxxxxxxxxxxxxxxxxxxxx
