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

1. Enabling Walk Up
Contributions to Your
Documentation
GlueCon
May 21, 2014 @ 4:15 pm
Everett Toews
Developer Advocate
@everett_toews

2. Intro
Developer

3. PMC and Committer on Apache jclouds

4. Intro
Advocate

5. Me

6. Intro
Operations

7. Co-author of the OpenStack Operations Guide
docs.openstack.org/ops

8. Documentation
Is Awful

9. It’s Awful
Ugly

10. It’s Awful
Out-Of-Date

11. It’s Awful
Non-Discoverable

12. It’s Awful
Hard To Change

13. Documentation
Is Awesome

14. It’s Awesome
Beautiful

15. It’s Awesome
Up-To-Date

16. It’s Awesome
Discoverable

17. It’s Awesome
Easy To Change

18. Documentation
Is Hard To Change

19. Hard to Change
Permissions

20. Hard to Change
People

21. Hard to Change
Formats

22. Hard to Change
Tool Chain

23. Hard to Change
Reviews

24. Documentation
Can Be Easy
To Change

25. Easy to Change
Anyone

26. Easy to Change
People

27. Easy to Change
Common
Formats

28. Easy to Change
Common
Tools

29. Easy to Change
Easy Reviews

30. How jclouds Enables
Walk Up
Contributions to
Documentation

31. Walk Up
GitHub

32. Walk Up
Web Browser

33. Walk Up
Markdown
HTML

34. The Backend

35. Walk Up
Jenkins

36. Walk Up
Jekyll

37. Walk Up
jclouds

38. Walk Up
Rackspace
Cloud Files

39. Walk Up
GitHub API

40. Let’s Make a
Contribution

41. Documentation
Contributor
(t-shirted and incognito)

42. Documentation
Committer
(hoodied)

43. Documentation
jclouds.apache.org

44. Documentation
Fix This Page

45. Culture

46. Community
• 2 PRs w/ 7 Participants
• 199 Comments
• 21 Screen Shots
• 41 Builds

47. Community
Not Just
Documentation

48. Community
Culture
of
Contribution

49. Thank You
jclouds.apache.org
Everett Toews
Developer Advocate
@everett_toews