Documentation Improvement Initiative

[H. S. Teoh]

On Thu, Feb 20, 2020 at 10:21:25AM +0000, John Colvin via Digitalmars-d wrote:
[...]
> My general problem with most docs is that I actually prefer the "one
> big page" approach per-module. The practical relationships between
> functions, objects, methods and members often aren't hierarchical and
> it's so much easier to get an overview by scrolling through a larger
> page.
> 
> The same reason applies to why I almost never use code-folding in an
> editor.

Yeah, the one-page doc is nicer because you can actually search for
keywords on the page and find what you want, instead of having to click
on who knows how many links just to get to the one place you already
know is there.


T

-- 
Marketing: the art of convincing people to pay for what they didn't need before which you fail to deliver after.