Enabling Walk UpContributions to Your

DocumentationGlueCon

May 21, 2014 @ 4:15 pm

Everett Toews

Developer Advocate

@everett_toews

Intro

Developer

PMC and Committer on Apache jclouds

Intro

Advocate

Me

Intro

Operations

Co-author of the OpenStack Operations Guide

docs.openstack.org/ops

DocumentationIs Awful

It’s Awful

Ugly

It’s Awful

Out-Of-Date

It’s Awful

Non-Discoverable

It’s Awful

Hard To Change

DocumentationIs Awesome

It’s Awesome

Beautiful

It’s Awesome

Up-To-Date

It’s Awesome

Discoverable

It’s Awesome

Easy To Change

DocumentationIs Hard To Change

Hard to Change

Permissions

Hard to Change

People

Hard to Change

Formats

Hard to Change

Tool Chain

Hard to Change

Reviews

DocumentationCan Be Easy

To Change

Easy to Change

Anyone

Easy to Change

People

Easy to Change

Common

Formats

Easy to Change

Common

Tools

Easy to Change

Easy Reviews

How jclouds Enables Walk Up

Contributions to Documentation

Walk Up

GitHub

Walk Up

Web Browser

Walk Up

Markdown

HTML

The Backend

Walk Up

Jenkins

Walk Up

Jekyll

Walk Up

jclouds

Walk Up

Rackspace

Cloud Files

Walk Up

GitHub API

Let’s Make a Contribution

Documentation

Contributor(t-shirted and incognito)

Documentation

Committer(hoodied)

Documentation

jclouds.apache.org

Documentation

Fix This Page

Culture

Community

• 2 PRs w/ 7 Participants

• 199 Comments

• 21 Screen Shots

• 41 Builds

Community

Not Just

Documentation

Community

Culture

of

Contribution

Thank You

jclouds.apache.org

Everett Toews

Developer Advocate

@everett_toews