Walk n Doc
Download as PPTX, PDF
0 likes798 views
The document discusses the challenges of traditional documentation and proposes using Walk n' Doc and jclouds to create documentation that is beautiful, up-to-date, discoverable, and easy to change. Walk n' Doc uses GitHub, Markdown/HTML formats, and a web browser along with easy reviews to improve upon documentation. jclouds in particular utilizes Jekyll, Jenkins, and cloud files to redesign its site through an open process with many participants, comments, and builds. The overall message is that Walk n' Doc and jclouds can establish a culture of contribution and improve documentation beyond just documentation.
Walk n Doc
- 3. Documentation is Awful Ugly Out-Of-Date Non-Discoverable Hard To Change
- 4. Documentation is Awesome Beautiful Up-To-Date Discoverable Easy To Change
- 5. Documentation is Hard to Change Permissions Formats Tool Chain Reviews
- 6. Documentation is Easy to Change Anyone Common Formats Common Tools Easy Reviews
- 7. Walk n Doc with jclouds GitHub Markdown/HTML Web Browser Easy Reviews
- 8. Jay-3 Jekyll Jenkins jclouds Cloud Files
- 17. jclouds Site Redesign 2 PRs w/ 7 Participants 199 Comments 21 Screen Shots 41 Builds
- 18. Bring It Home Not Just Documentation
- 20. Bring It Home Thank You jclouds.apache.org @everett_toews