Git workflow
by Karsten Wade
All:
There have been discussions amongst e.g. Jason, Shaun, Michael, myself,
Brian Proffitt, and maybe others around how we want to use and avoid
misusing GitHub as part of our writing workflow. This topic is of
general interest to other writers we know who work on upstream
documentation in various ways.
https://github.com/theopensourceway/guidebook
My thinking/guidance is mainly:
1. Let's make sure we can get work done toward our goal -- writing,
editing, publishing in a way that works for the contributors is top
priority.
2. Don't paint ourselves into any corners, i.e. lock ourselves into a
forever-stuck-on-GitHub tooling.\
In support of #2, I think it would be good to say that our decisions
here are to cover the production of the 2.0 work. At that time we take a
serious review of our experiences so far and see how we can move toward
100% FOSS for all parts of the project.
For #1, what do you all think? How do you want to use PRs and Issues
around writing chapters and sections?
Best,
- Karsten
--
Karsten Wade [he/him/his]| Senior Community Architect | @quaid
Red Hat Open Source Program Office (OSPO) : @redhatopen
https://community.redhat.com | https://next.redhat.com | https://theopensourceway.org
gpg: AD0E0C41 | https://red.ht/sig
5 years
Getting going on TOSW 2.0
by Karsten Wade
Hey all,
Thanks for joining us here, this list is seeded with the folks from Red
Hat's Open Source Program Office (OSPO) team who are taking specific
roles in the project to start.
To get us started, these are the current efforts underway/need to start
-- each needs a new email thread for discussion here:
* GitHub discussion - which tools, what process
* Style Guide - BKP has a solid draft for us
* Contributor process & resulting Contrib Guide - Shaun is leading this
discussion, as it covers the writing and review process, who approves
what, etc.; needs answers from GitHub discussion.
* Code of Conduct -- not just for the collaborators' interactions, but
also thoughtful, living guidance on content itself so we are
writing/taking contributions & editing with diversity, civility, and
inclusion in mind.
With those efforts underway, plus this mailing list, we can begin
inviting writers directly to take assignments and get writing!
I'm quite excited and nervous to be working on this project with you and
all our new contrib friends. Welcome, one and all.
Best regards,
- Karsten
--
Karsten Wade [he/him/his]| Senior Community Architect | @quaid
Red Hat Open Source Program Office (OSPO) : @redhatopen
https://community.redhat.com | https://next.redhat.com | https://theopensourceway.org
gpg: AD0E0C41 | https://red.ht/sig
5 years