...this is questionable advice that goes against the interest of programmers having stuff to do - we're not segmented into audiences. We want multi-level docs

...this is questionable advice that goes against the interest of programmers having stuff to do - we're not segmented into audiences. We want multi-level docs combined/spliced/interwoven together so we can get our work done without wasting gandalfing the docs. > While redesigning the Cloudflare developer docs ...oh, so this is the reason for CF's docs totally uncomprehensible and confusing mess. They've made getting to anythin so comfusing that AWS seems a breath of fresh air in comparison. I dunno, maybe other peoples' brains are wired totally different than mine, but boy, these new fever of "writing better docs" seems to produce the exact opposite effects whenever applied. The few enojoyable docs nowadays seem to be written by old-school unixy geeks and/or people that are not programmers or worse, "documentation developers": physicists, mathematicians, biologists, quants, data analysts etc. seem to do a nice job when they have the time.