Enabling Walk Up
Contributions to Your
Documentation
ApacheCon
April 8, 2014 @ 1:30 pm
Everett Toews
Developer Advocate
@e...
Intro
Developer
PMC and Committer on Apache jclouds
Intro
Advocate
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
Walk Up
Jekyll
Walk Up
Jenkins
Walk Up
jclouds
Walk Up
Rackspace
Cloud Files
Let’s Make a
Contribution
Documentation
Contributor
(t-shirted and incognito)
Documentation
Committer
(hoodied)
Documentation
jclouds.apache.org
Documentation
Fix This Page
Let’s Look at
the Backend
Documentation
jclouds.ci.cloudbees.com/v
iew/docs/
Community
Documentation
Not Just
Documentation
Documentation
Community
Through
Contribution
A Challenge!
Documentation
jclouds.apache.org/blog/
Documentation
Write a
guest post!
Thank You
jclouds.apache.org
Everett Toews
Developer Advocate
@everett_toews
Enabling Walk Up Contributions to Your Project Documentation
Upcoming SlideShare
Loading in...5
×

Enabling Walk Up Contributions to Your Project Documentation

256

Published on

An overview of how Apache jclouds enables walk up contributions to our project documentation at ApacheCon 2014.

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

  • Be the first to like this

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

No notes for slide

Enabling Walk Up Contributions to Your Project Documentation

  1. 1. Enabling Walk Up Contributions to Your Documentation ApacheCon April 8, 2014 @ 1:30 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. Intro Operations
  6. 6. Co-author of the OpenStack Operations Guide docs.openstack.org/ops
  7. 7. Documentation Is Awful
  8. 8. It’s Awful Ugly
  9. 9. It’s Awful Out-Of-Date
  10. 10. It’s Awful Non-Discoverable
  11. 11. It’s Awful Hard To Change
  12. 12. Documentation Is Awesome
  13. 13. It’s Awesome Beautiful
  14. 14. It’s Awesome Up-To-Date
  15. 15. It’s Awesome Discoverable
  16. 16. It’s Awesome Easy To Change
  17. 17. Documentation Is Hard To Change
  18. 18. Hard to Change Permissions
  19. 19. Hard to Change People
  20. 20. Hard to Change Formats
  21. 21. Hard to Change Tool Chain
  22. 22. Hard to Change Reviews
  23. 23. Documentation Can Be Easy To Change
  24. 24. Easy to Change Anyone
  25. 25. Easy to Change People
  26. 26. Easy to Change Common Formats
  27. 27. Easy to Change Common Tools
  28. 28. Easy to Change Easy Reviews
  29. 29. How jclouds Enables Walk Up Contributions to Documentation
  30. 30. Walk Up GitHub
  31. 31. Walk Up Web Browser
  32. 32. Walk Up Markdown HTML
  33. 33. Walk Up Jekyll
  34. 34. Walk Up Jenkins
  35. 35. Walk Up jclouds
  36. 36. Walk Up Rackspace Cloud Files
  37. 37. Let’s Make a Contribution
  38. 38. Documentation Contributor (t-shirted and incognito)
  39. 39. Documentation Committer (hoodied)
  40. 40. Documentation jclouds.apache.org
  41. 41. Documentation Fix This Page
  42. 42. Let’s Look at the Backend
  43. 43. Documentation jclouds.ci.cloudbees.com/v iew/docs/
  44. 44. Community
  45. 45. Documentation Not Just Documentation
  46. 46. Documentation Community Through Contribution
  47. 47. A Challenge!
  48. 48. Documentation jclouds.apache.org/blog/
  49. 49. Documentation Write a guest post!
  50. 50. 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.

×