Hacker News new | ask | show | jobs
by abridgett 1736 days ago
It didn't really seem to have any prioritisation - e.g. around titles, headings or any metadata (view count, edits, last updates). Agree completely it was awful.

OTOH I'm also a believer that you should be able to navigate to the right information.

People seem to think that writing pages is sufficient. A library works because pages are gathered in books, organised by sections and has an army of librarians to keep it running smoothly.

I treat documentation like code - DRY, refactor apply just the same. e.g. I might split a page up so that some common part can be re-used. I'll cull obsolete information or mark it obsolete. I'll _also_ updated headings to help them show up in searches.