How can we make it easier to experiment with the compiler?

[Patrick Schluter]

On Thursday, 27 May 2021 at 05:36:55 UTC, Nicholas Wilson wrote:
> On Thursday, 27 May 2021 at 04:53:12 UTC, Walter Bright wrote:
>> On 5/26/2021 8:06 PM, Walter Bright wrote:
>>> [...]
>>
>> I see this has already been done:
>>
>> https://github.com/dlang/dmd/blob/master/src/dmd/README.md
>>
>> It's a bit out of date, files like typesem.d are missing.
>
> I know, I wrote the equivalent for the backend. And no that 
> does not accomplish the _same_ thing, not even remotely close. 
> The fact you only just found out about it shows that:
> a) you have never used the README, and
> b) know your way around well enough to not need it, which shows 
> the implication that
> c) you have no perspective from those who would have use for 
> either a README or better structured files and know nothing 
> about the relative benefits of either of them.
>
> Yes, a README is strictly better than nothing. It does not 
> substitute for having organised files. Neither does well 
> organised files substitute for a lack of README.

and adding to that by citing Walters message "It's a bit out of 
date, files like typesem.d are missing." shows the inherent 
problem of a separate README file. Organized files are self 
documenting, readme's are not.