From The_Open_Source_Way

(Difference between revisions)
Jump to: navigation, search
(Version control: "in to a VCS" -> "into a VCS")
(What this book is)
Line 22: Line 22:
# A thin reference guide to richer, thicker works that explain Big Principles in Lots of Fancy Words.
# A thin reference guide to richer, thicker works that explain Big Principles in Lots of Fancy Words.
# An open how-to manual, initially authored by the Red Hat [ Community Architecture] team.
# An open how-to manual, initially authored by the Red Hat [ Community Architecture] team.
# Useful for much more than just code -- art/design, documentation, marketing, sales, translation, IT, and so on
# Useful for much more than just code - art/design, documentation, marketing, sales, translation, IT, and so on.
== What it is not ==
== What it is not ==

Revision as of 01:20, 2 August 2010

This book provides an introduction to creating and nurturing communities of contributors. This is a core part of Red Hat's mission, as manifested in the many communities where Red Hat is an active contributor.

Red Hat employs contributors who work directly in upstream development on all parts of the open source architecture stack, from the Linux kernel to the thinnest skin of Ajax4Jsf. How these people interact with their communities is the first part of how Red Hat influences the growth of community.

The qualities of the interaction of each individual contributor are as different as any human-to-human interaction. Over the course of time, these many interactions distill to a set of guiding principles that help us with community growth and nurturing.

Red Hat has collective community wisdom.

We also have particular skill and luck in being thought and action leaders in many open communities. It has all been done in an open, ad hoc fashion, and it hasn't been written down before.

This book captures that distilled knowledge. It is also an active document. As that knowledge grows and changes, so do the contents of this book.

This book is small and written on a wiki to facilitate collaboration and growth. If you have ideas to improve the The Open Source Way, you are encouraged to just start writing it down. Use a page's "discussion" tab to access the talk page.


What this book is

  1. A book that:
    1. ... describes a principle
    2. ... explains how to implement it
    3. ... and gives real world examples.
  2. A thin reference guide to richer, thicker works that explain Big Principles in Lots of Fancy Words.
  3. An open how-to manual, initially authored by the Red Hat Community Architecture team.
  4. Useful for much more than just code - art/design, documentation, marketing, sales, translation, IT, and so on.

What it is not

  1. Comprehensive for the sake of inclusion.
    • We are focused on slim and useful.
  2. Overly repetitive of content already said and available elsewhere as free and open.
    • Build on the work of others via the power of reference.
  3. Boring.

What it is influenced by

There are some very comprehensive, thorough, and useful works, such as:

More influencers and good reads are found in Books you should read and Data and references.

Essential terminology or 'Read this even if you think you know what it means'

This section is growing for a while as the The Open Source Way is written and terms need defining.


When people talk about community, they may be talking about very different things:

  • People who use something.
  • People who like something.
  • People who advocate for something.
  • People who enable others to use something.
  • People who contribute to improve something.
  • ... and so on.

When we talk about community in the The Open Source Way, we mean the community of contributors who are a superset to all other communities. The ones who, by getting things done, make it possible for many, many more to get much, much more done.

This is the group of people who form intentionally and spontaneously around something important to them. It includes the people who use or benefit from the project, those who participate and share the project to wider audiences, and the contributors who are essential to growth and survival.

Contributors are the oxygen. Without it, the animal chokes and dies.

The community that contributes to improve something is the one that defines something for the next generation of users, advocates, and enablers.


This is derived from military terminology. The common example is a group of soldiers who work with a squad leader to take and secure a hill.

Tactics are the ideas, plans, methods, and means used to accomplish a goal. That is, tactics are the maneuvers used to achieve an objective that is set by strategy.

In Fedora, the strict yet clever packaging guidelines are a strong-arm tactic that enforces the Fedora strategy of good packaging of only free and open source software.


Strategy focuses on everything from which hill to secure, to deciding which miltary campaigns to engage in.

A term from military science, strategy is the focus of the command group. Strategy focuses on setting goals and which groups can obtain the goals.

Once the "who, what, where, when, and why" is decided, tactics takes over as the "how".

The Fedora strategy of creating and supporting only FLOSS is derived from the culture of the community combined with a pragmatic view of the legal and business landscape.

Planets and blogs

A blog is a mix of personal and project writing that comes from a participant or contributor.

The idea of a blog planet is to show the width and depth of personalities in a community, and what they are doing.

It intentionally allows for personal expression. In other words, the content is not all community-specific. It is sometimes wildly off topic.

The Fedora Planet is a good example, with blogs aggregated from willing contributors. People add themselves to the planet, and it is a mix of languages, topics, skill levels, and project interest. All aspects of the Fedora Project are covered there on a daily basis, with a wide variety of contributors from Packaging, Art and Design, Marketing, upstream development, and so on.

Leaderless organizations

A leaderless organization is decentralized, meaning it does not rely upon a central authority for leadership, strategy, or tactics. Being decentralized makes it easier to heal, faster to respond and innovate, and more able to grow in scale.

An example of a large leaderless organization is the Internet. Not just the set of agreements that makes the structure work, but all the way down to the wire protocols that route around damage in the network, such as when a backhoe slices through a fiber link between two ISPs.

In projects, Wikipedia is a decentralized organization, while the Encyclopaedia Brittanica is a classic centralized organization.

The idea of the leaderless organization is put forth in the book The Starfish and The Spider.

Version control

Version control is the comfortable insurance that means you can sleep soundly at night.

A version control system (VCS) keeps track of the differences in versions of content. Properly implemented, it is nearly disaster proof.

When a document is saved into a VCS, the difference between the current saved copy and the one just before it is stored. The same occurred at all previous saves. This makes it possible to restore a document to any point in its save history. It is also possible to return to a previous save point and start a new pathway of saves from there. In code this is called branching, with the original code in the central trunk.

When you work with a web-based tool to write, edit, and display a document, you are using version control. All content management systems and wikis use a form of version control to capture and display the differences between edits.

Version control provides noisy reporting. Anyone who is interested or able may watch the stream of changes, or derive reports from them. Watching and commenting on version saves as they occur is a hallmark of the open source methodology.

Content v. code repositories

Code is a specialized form of content. There are many similarities between repositories of code and content. The major difference is in the tools.

Code repository tools focus on centralized or decentralized development of the code. The ability to return to a point in time and branch from there is essential.

Content repository tools also include the ability to return to previous points in a documents save history. They also include management tools, such as team automation in MediaWiki, and workflow, publishing, and lifecycle components in a content management system (CMS).

Open collaboration tools

These are examples of open collaboration tools used in the open source communities. The same or similar tools apply to any online community of practice.

  • What is a wiki?
  • What is a mailing list?
  • What is IRC?

Open marketing

This is marketing done entirely in the open, no secret discussions on brand tactics behind the Wizard's curtain. You talk about your strengths, weaknesses, brand position, and so forth as an ongoing open discussion.

Central to this are social media tools. Some are used for discussions, some are for information dispersal, but any vector is a potential for learning and spreading the word.

  • Blogging planet or otherwise aggregated feed of all contributors
  • Publicly displayed and discussed content and code committing
  • Always being watched
    • All mailing list traffic
    • All IRC logs
    • All voice sessions logged and available
    • 100% totally accountable discussions
    • Radically transparent

Fundamental rule - do not bash competitors

In fact, ignore them when talking about your project. Why waste the attention you've got on your project to point attention at something else?

Fundamental rule - be radically transparent

There is no such thing as too much information. Everything you can legally say, you should be saying.

Don't use this as an excuse to be verbose or disorganized.

Fundamental rule - explain what you know and how you know it

In the general category of being honest, spend some time with revealing sources and means. Bad numbers are everywhere in software and communities. Make sure your numbers are real and provable.

This also falls in the general methodology of thinking like a scientist.


We may all be social artists in our communities, but in the end, our understanding of this is all driven by science.

There is an active feedback loop happening right now:

  1. Scientific method wildly successful and bringing forth new, life altering ideas and innovations ...
  2. Scientific method is a direct parent of the open source methodology ...
  3. Open source way practiced in business/private sector ...
  4. Influences academia ...
  5. Influences public/government ...
  6. Funds science and supports innovation ...
  7. Iterating through more ideas for the Great Ones ...
  8. (Back to top)

The open source way is breaking through to help make new ideas happen ... in organizations that brought us the ideas of free government and free, public education ... ideas that were revolutionary and evolutionary in the 19th century ... that fueled a century of innovation ... and are now getting refueled by new ways of openly collaborating on infrastructures of freedom.

Personal tools