Guidebook

This repository contains source materials for The Open Source Way 2.0, a (somewhat opinionated) guidebook for anyone interested in managing open source communities. It collects best practices for initiating, nurturing, growing, and maintaining groups of passionate contributors.

The Open Source Way 2.0 refreshes pre-existing materials on these topics.

Getting started

This project uses AsciiDoc and a git-based workflow. We track editorial, technical, governance, and marketing discussions on their respective project boards.

Each chapter is an .adoc file that is associated with an issue. The chapter contains its own outline, content, and lexicon.

Each section is an .adoc file that contains the outline of chapters for that section. Each section has one or more chapters in it. There is not an issue associated with a section, unless a new section is being created.

Want to get involved?

Come talk with us on the mailing list and see CONTRIBUTING.md to learn how to make your first contribution.

Community architecture

For the 2.0 refresh, we've defined a set of roles and responsibilities around an initial, core group of contributors most familiar with the goals of the project. Beyond that, we'll evolve with the participation of new contributors and update CONTRIBUTING.md to reflect current contribution guidelines.

At the moment:

• Project Lead Karsten Wade (@quaid) is responsible for providing vision and leadership to evolve from his original 1.0 work
• Lead Editor Brian Proffitt (@bproffitt) is responsible for leading a team of editors to work with multiple authors and content sources toward a cohesive, highly readable guide
• Lead Writer Shaun McCance (@shaunix) is responsible for working directly with writers to shape their content into the level, style, and narrative of the overall guide
• Editing team (Brian Proffitt, Karsten Wade, Shaun McCance) is responsible for polishing and integrating submissions to ensure consistency of quality and voice
• Writing team (Bryan Behrenshausen (@semioticrobotic), Brian Proffitt, Karsten Wade, Shaun McCance) is responsible for composing, collecting, and otherwise curating materials included in the guidebook.