Hacker News new | past | comments | ask | show | jobs | submit
Quite a few people do believe that a good specification is long, has multiple levels of headings, interspersed bold text, bullet points, and so on. Definitely, this is what they have seen happen throughout their lives: competent people have heaped praise on documentation which has had these signs, so this must be what good documentation looks like.