The Joys of Open-Source Docs
by Maxwell Joslyn. .
Yesterday's good deed: revising and rewriting technical documentation for a cryptocurrency company's open-source project.
I've long had the habit of emailing people I find on the Web to notify them of typos, or dead webpages, but only recently have I realized:
- how little time and energy companies typically devote to writing documentation (relative to resources spent on the systems being documented)
- how many projects have software docs and similar written resources in public version control repos
- how easy it is to fix written documents when they're hosted on version control platforms like GitHub
I hope to continue helping out with FOSS projects' technical-writing needs, especially when there's an opportunity to help Chinese-speaking teams translate material into native English.