Walk n Doc

468 views

Published on

My Walk n Doc lightning talk from DevOpsDays Austin 2014.

Published in: Software, Technology, Business
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
468
On SlideShare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
2
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Walk n Doc

  1. 1. Walk n’ Doc Documentation
  2. 2. Documentation is Awful • Ugly • Out-Of-Date • Non-Discoverable • Hard To Change
  3. 3. Documentation is Awesome • Beautiful • Up-To-Date • Discoverable • Easy To Change
  4. 4. Documentation is Hard to Change • Permissions • Formats • Tool Chain • Reviews
  5. 5. Documentation is Easy to Change • Anyone • Common Formats • Common Tools • Easy Reviews
  6. 6. Walk n’ Doc with jclouds • GitHub • Markdown/HTML • Web Browser • Easy Reviews…
  7. 7. Jay-3 • Jekyll • Jenkins • jclouds • Cloud Files
  8. 8. jclouds Site Redesign • 2 PRs w/ 7 Participants • 199 Comments • 21 Screen Shots • 41 Builds
  9. 9. Bring It Home Not Just Documentation
  10. 10. Bring It Home Culture of Contribution
  11. 11. Bring It Home Thank You jclouds.apache.org @everett_toews

×