This is never stupid to repeat basics : I thought I wanted to write a tutorial 
on macro and template programming, but ended up making a mix between the last 
three. 
<https://dlesnoff.github.io/nimProgramming-blog/blogPosts/macroTutorial.html> 
Its not easy to find the correct tone when we don't know to whom we address our 
text in the first place :p I am satisfied with my bibliography/reference 
section. I am torn up between making a tutorial to explain what is an AST (with 
a lot of drawings), a how-to to explain the design/development process behind 
the development of a macro, or a book explaining all the subtleties with 
bindSym, variable injection, DSL design ...

@jtv I want to fall back to the initial discussion of the thread and propose a 
related issue concerning the documentation.

<https://github.com/nim-lang/Nim/issues/20754> Many people approved the idea, 
but I don't know how to start fixing it. Nobody proposed something to define 
where to put global comment on overloaded function. Should I modify this file 
<https://github.com/nim-lang/Nim/blob/devel/config/nimdoc.cfg> ?

Looking at it, there are plenty of seemingly easy to fix issues for the 
documentation: 
<https://github.com/nim-lang/Nim/labels/Documentation%20Generation> 
<https://github.com/nim-lang/Nim/issues/13552>

Reply via email to