Settings

Theme

Mapbox releases tool to automatically review technical docs

mapbox.com

6 points by zetalabs 10 years ago · 1 comment

Reader

shdon 10 years ago

I'm all for clear and concise documentation, and can appreciate the technical merit of this approach. On the other hand, some of the examples they give horrify me. In many cases, added words or synonyms make a text more readable. I might be wrong, but my gut feeling is that this makes something that is already barely readable (tech specs) into something completely impossible to get through without getting bored after 3 paragraphs or feeling like my intelligence has been insulted.

Keyboard Shortcuts

j
Next item
k
Previous item
o / Enter
Open selected item
?
Show this help
Esc
Close modal / clear selection