News for hackers. Stuff that matters.
Re:Mu: making programs easier to understand in the large by dman on Saturday February 13, 2016 @10:26AM (#11094257)
I think the project would benefit from a Terminology / Definitions section which lists in one table the names and crisp definitions of the concepts being introduced. It appears that you are using non standard terms so having a single list of the terms would allow readers to have that list open when they are reading through the layers.
Re:Mu: making programs easier to understand in the large by akkartik on Saturday February 13, 2016 @04:58PM (#11095829)
That's a good idea. Might http://akkartik.github.io/mu/html/010vm.cc.html [1] be such a big-picture map? Let me think about how to improve it; I haven't touched it in a while. Further suggestions most welcome.

[1] Colorized version of https://github.com/akkartik/mu/blob/379244666c/010vm.cc

Re:Mu: making programs easier to understand in the large by dman on Saturday February 13, 2016 @08:10PM (#11096586)
I was thinking something much simpler. If you were writing a book about Mu what would be the definitions you would print on the back inner cover? A table with two columns - first column being a term and the second column containing its description in one or two sentences.

Could you elaborate on the target audience for the doc you linked to? I am unable to make out whether that doc is intended for serious programmers in other languages coming across Mu for the first time or whether its intended for new comers to programming.

Re:Mu: making programs easier to understand in the large by akkartik on Saturday February 13, 2016 @11:26PM (#11097132)
Yeah the intended audience is existing C++ programmers coming across Mu for the first time. For teaching programming I mostly imagine I'll be doing it in person. Mu isn't yet ready for learning programming unassisted.