This is very interesting, I've been following the discussion around Architecture.md [0], one of the issues mentioned was updating the doc. Going for a standardised way of organising the project might be helpful.
I've recently been working on simulations again and C++ has sparked my interest (also again, after not having touched it since CS106B), but I've had a hard time understanding some of the projects I've seen due to a lack of documentation. Irrespective of language, I do like this approach to have some predetermined and thought through way of structuring projects, both for other users and for the future self, without the overhead of adding much documentation.
I've recently been working on simulations again and C++ has sparked my interest (also again, after not having touched it since CS106B), but I've had a hard time understanding some of the projects I've seen due to a lack of documentation. Irrespective of language, I do like this approach to have some predetermined and thought through way of structuring projects, both for other users and for the future self, without the overhead of adding much documentation.
[0]: https://news.ycombinator.com/item?id=26048784