Kenneth Reitz

Number of videos:
2
Documentation at Scale
NA 2014
Kenneth Reitz
Recorded: May 5, 2014Language: English

Information is powerful — every day we see it transform the world around us.

Documentation doesn't always have to be about a software workflow or open source project — it can be used to develop and convey ideas much larger than yourself. Information architecture is a powerful tool for developing ideas over time. It enables us to evolve and distill information at a much larger scale than a single person or team could ever achieve on their own.

Take these concepts, and apply open source workflow tools like GitHub's Pull Requests and Write the Docs, and the distributed evolution of ideas and information has never been more accessible.

We'll explore these concepts, learn how to foster a community of distributed contributors, encourage contributions early on, and more.

Python-Guide.org will be used as an example, a Python-specific knowledge base written by 168 people and accessed by over 50,000 people every month.

Documentation is King
NA 2013
Kenneth Reitz
Recorded: April 8, 2013Language: English

Documentation leads to better code. Every design decision should be documented. Imagine not having to have tap your coworkers on the shoulder when you’re working on an unfamiliar part of the codebase, or on-boarding a new employee. Imagine being able to make the change, run the tests, and push to production without questioning yourself, because the process was documented — or better yet, automated.