On Thursday, 23 July 2015 at 17:34:45 UTC, Adam D. Ruppe wrote:
Feature template: What it isso like a mixin template is a list of declarations with namesCore concept in usage mixin template example, basic use use with templates use with a name to mix in overloads Where it is used in tutorials and other places IRLThat's the skeleton outline for how I want to do docs. The "what it is" we kinda have now, though it could often be clearer, but we don't have the nice examples (well, outside of things like my book) and we certainly don't have the top-level how to do X in the whole ecosystem, and the interlinking to learn more.
Definitely sounds interesting.
That would be good. I also think a top-level "the boss whats you to do X and needs it by end of day, follow these steps to learn how and read these links to dive deeper" would be super useful. They should feed into each other.
I actually just had your D Cookbook delivered a few days ago. Beyond a few cases of extra semi-colons, one of the things that really stood out were where you took something I would find very complicated, describe the few key steps to accomplish the complicated task, and then follow up with a bunch of code that does those steps. I like that teaching method.
