Enabling Walk Up
Contributions to Your
Documentation
GlueCon
May 21, 2014 @ 4:15 pm
Everett Toews
Developer Advocate
@ever...
Intro
Developer
PMC and Committer on Apache jclouds
Intro
Advocate
Me
Intro
Operations
Co-author of the OpenStack Operations Guide
docs.openstack.org/ops
Documentation
Is Awful
It’s Awful
Ugly
It’s Awful
Out-Of-Date
It’s Awful
Non-Discoverable
It’s Awful
Hard To Change
Documentation
Is Awesome
It’s Awesome
Beautiful
It’s Awesome
Up-To-Date
It’s Awesome
Discoverable
It’s Awesome
Easy To Change
Documentation
Is Hard To Change
Hard to Change
Permissions
Hard to Change
People
Hard to Change
Formats
Hard to Change
Tool Chain
Hard to Change
Reviews
Documentation
Can 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
Upcoming SlideShare
Loading in...5
×

Enabling Walk Up Contributions to Your Documentation at GlueCon

294

Published on

My presentation on enabling walk up contributions to you documentation at GlueCon 2014.

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

  • Be the first to like this

No Downloads
Views
Total Views
294
On Slideshare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
1
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Enabling Walk Up Contributions to Your Documentation at GlueCon

  1. 1. Enabling Walk Up Contributions to Your Documentation GlueCon May 21, 2014 @ 4:15 pm Everett Toews Developer Advocate @everett_toews
  2. 2. Intro Developer
  3. 3. PMC and Committer on Apache jclouds
  4. 4. Intro Advocate
  5. 5. Me
  6. 6. Intro Operations
  7. 7. Co-author of the OpenStack Operations Guide docs.openstack.org/ops
  8. 8. Documentation Is Awful
  9. 9. It’s Awful Ugly
  10. 10. It’s Awful Out-Of-Date
  11. 11. It’s Awful Non-Discoverable
  12. 12. It’s Awful Hard To Change
  13. 13. Documentation Is Awesome
  14. 14. It’s Awesome Beautiful
  15. 15. It’s Awesome Up-To-Date
  16. 16. It’s Awesome Discoverable
  17. 17. It’s Awesome Easy To Change
  18. 18. Documentation Is Hard To Change
  19. 19. Hard to Change Permissions
  20. 20. Hard to Change People
  21. 21. Hard to Change Formats
  22. 22. Hard to Change Tool Chain
  23. 23. Hard to Change Reviews
  24. 24. Documentation Can Be Easy To Change
  25. 25. Easy to Change Anyone
  26. 26. Easy to Change People
  27. 27. Easy to Change Common Formats
  28. 28. Easy to Change Common Tools
  29. 29. Easy to Change Easy Reviews
  30. 30. How jclouds Enables Walk Up Contributions to Documentation
  31. 31. Walk Up GitHub
  32. 32. Walk Up Web Browser
  33. 33. Walk Up Markdown HTML
  34. 34. The Backend
  35. 35. Walk Up Jenkins
  36. 36. Walk Up Jekyll
  37. 37. Walk Up jclouds
  38. 38. Walk Up Rackspace Cloud Files
  39. 39. Walk Up GitHub API
  40. 40. Let’s Make a Contribution
  41. 41. Documentation Contributor (t-shirted and incognito)
  42. 42. Documentation Committer (hoodied)
  43. 43. Documentation jclouds.apache.org
  44. 44. Documentation Fix This Page
  45. 45. Culture
  46. 46. Community • 2 PRs w/ 7 Participants • 199 Comments • 21 Screen Shots • 41 Builds
  47. 47. Community Not Just Documentation
  48. 48. Community Culture of Contribution
  49. 49. Thank You jclouds.apache.org Everett Toews Developer Advocate @everett_toews
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×