> It turns out that it's not necessary to have fancy formatting in order to comm... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		CGamesPlay on Dec 9, 2019 \| parent \| context \| favorite \| on: Must and Must Not: On writing documentation > It turns out that it's not necessary to have fancy formatting in order to communicate clearly; in fact, fancy formatting often distracts from the message you are trying to get across. Man I wish the JavaScript community would grasp this better. I’m looking at you, GitBooks!

52-6F-62 on Dec 9, 2019 [–]

At least they still render with JS disabled. Gotta love when a text document won't render without script bundles.

Consider applying for YC's Winter 2026 batch! Applications are open till Nov 10
Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact