Walk n’ Doc

Documentation

Documentation is Awful

• Ugly

• Out-Of-Date

• Non-Discoverable

• Hard To Change

Documentation is Awesome

• Beautiful

• Up-To-Date

• Discoverable

• Easy To Change

Documentation is Hard to Change

• Permissions

• Formats

• Tool Chain

• Reviews

Documentation is Easy to Change

• Anyone

• Common Formats

• Common Tools

• Easy Reviews

Walk n’ Doc with jclouds

• GitHub

• Markdown/HTML

• Web Browser

• Easy Reviews…

Jay-3

• Jekyll

• Jenkins

• jclouds

• Cloud Files

jclouds Site Redesign

• 2 PRs w/ 7 Participants

• 199 Comments

• 21 Screen Shots

• 41 Builds

Bring It Home

Not Just

Documentation

Bring It Home

Culture

of

Contribution

Bring It Home

Thank You

jclouds.apache.org

@everett_toews