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