enabling walk up contributions to your documentation at gluecon
DESCRIPTION
My presentation on enabling walk up contributions to you documentation at GlueCon 2014.TRANSCRIPT
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
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