mirror of
https://github.com/kennethreitz/kennethreitz.org.git
synced 2026-06-05 22:50:17 +00:00
16 lines
1.7 KiB
Markdown
16 lines
1.7 KiB
Markdown
# Documentation at Scale
|
|
|
|
<iframe class="speakerdeck-iframe" style="border: 0px; background: padding-box rgba(0, 0, 0, 0.1); margin: 0px; padding: 0px; border-radius: 6px; box-shadow: rgba(0, 0, 0, 0.2) 0px 5px 40px; width: 100%; height: auto; aspect-ratio: 560 / 420;" frameborder="0" src="https://speakerdeck.com/player/3200af20b6e5013184ad42b7f74d85e8" title="Documentation at Scale" allowfullscreen="true" data-ratio="1.3333333333333333"></iframe>
|
|
|
|
|
|
### Key Concepts
|
|
- **Communication Evolution**: From one-to-one to many-to-many, enabled by the internet.
|
|
- **Power of Documentation**: Documentation extends ideas beyond individuals, allowing for collaborative growth and development.
|
|
- **Tools for Scale**: Modern tools like GitHub and Read the Docs<label for="sn-rtd-revolution" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-rtd-revolution" class="margin-toggle"/><span class="sidenote">Read the Docs revolutionized documentation by automatically building and hosting docs from Git repositories, making it trivial to maintain up-to-date documentation alongside code.</span> facilitate version-controlled, collaborative documentation.
|
|
|
|
### Call to Action
|
|
- **Expand Beyond Tech**: Use documentation to develop ideas in humanities, arts, and sciences<label for="sn-cross-disciplinary" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-cross-disciplinary" class="margin-toggle"/><span class="sidenote">This vision anticipates platforms like GitBook, Notion, and Obsidian that democratize knowledge creation across disciplines, not just software development.</span>.
|
|
- **Build and Improve Tools**: Encourage competition and innovation in documentation tools.
|
|
|
|
[Explore More](http://Python-Guide.org)
|