On Friday, 17 June 2016 at 20:59:46 UTC, jmh530 wrote:
I found the beginning of the tutorial very clear. I really
liked that it can produce a png of the build graph. I also
liked the Lua build description for DMD. Much more legible than
the make file.
However, once I got to the "Going Meta: Building the Build
Description" section of the tutorial, I got a little confused.
I found it a little weird that the json output towards the end
of the tutorial don't always match up. Like, where did the .h
files go from the inputs? (I get that they aren't needed for
running gcc, but you should mention that) Why is it displaying
cc instead of gcc? I just feel like you might be able to split
things up a little and provide a few more details. Like, this
is how to do a base version, then say this is how you can
customize what is displayed. Also, it's a little terse on the
details of things like what the cc.binary is doing. Always err
on the side of explaining things too much rather than too
little, IMO.
Thank you for the feedback! I'm glad someone has read the
tutorial.
I'm not happy with that section either. I think I'll split it up
and go into more depth, possibly moving it to a separate page. I
also still need to write docs on the Lua parts (like cc.binary),
but that API is subject to change.
Unlike most people, I kind of actually enjoy writing
documentation.