What I've learned while trying to port my game engine to PS Vita

[Nicholas Wilson]

On Thursday, 23 June 2022 at 03:12:30 UTC, Hipreme wrote:
> There comes a big list:
>
> - The druntime is an obscure monster in which only those which 
> have been fighting against it for years can understand it. 
> Simply hard to know what each function does, hard to find 
> function signatures, even its definitions. There is `mixin` 
> statements generating core functions which does not even have a 
> comment saying `//Generates _d_somefunction`. A comment showing 
> which kind of syntax triggers that function would be really 
> helpful.
> ...
> I really tried my best trying to help or understanding custom 
> runtimes, but they are really hard for amateurs to touch their 
> hand on it while even trying to do the basic. They should be 
> documented, because there's a lot of code that feels manually 
> written to feel obscured for no one understanding it, the 
> variables names, the lack of comments on the hook functions, 
> its simply bizarre.

If you haven't already and one doesn't already exist, could you 
please add an issue regarding the documentation of this to 
issues.dlang.org ?