3 ms·
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 intro
by dman 11y ago
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.
- akkartik 11y agoThat's a good idea. Might http://akkartik.github.io/mu/html/010vm.cc.html 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 https://github.com/akkartik/mu/blob/379244666c/010vm.cc
- dman 11y agoI 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.
- akkartik 11y agoYeah 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.