Suggestion re the manual

[Rob T]

On Tuesday, 7 June 2022 at 21:28:30 UTC, Paul wrote:

> Having the public post examples, gotchas, and other helpful 
> information made a world of difference in learning the PHP 
> language, all the while having the "source of truth" directly 
> above.
>

I think that's a great idea *if* done properly. For example we'd 
have to be careful to ensure that the comments are not misleading 
or incorrect, the comments should NOT directly be a part of the 
documentation, which should always remain a separate item.

How to manage and design such a thing needs some thought, but I 
see no reason why it's not possible. We could for example, only 
allow known D members as contributors to ensure quality. We could 
use a database with links to the separate comments to keep the 
two spaces complete separate (except we do need the links in 
there somehow).