> <https://dlesnoff.github.io/nimProgramming-blog/blogPosts/macroTutorial.html>
(Beware, I'm Dutch, thus direct in a way considered rude by many.) I only read the template section, that took some effort. The dark theme and the choice of colours and contrast levels make it very hard to read. The black/orange things jump at you and distract. The code is too flat. I had to switch/toggle to reader view in firefox (dark grey on off-white). What I miss in the template section; Why and when to use templates? Why not use a proc? If you don't know who to write for, aim for a lower starting knowledge of your audience but make it clear that you're going in deep in a later section. The layering mentioned earlier in this thread. As an example, you mention C/C++, something that is meaningless to me. Or, dive in deep from the start, you'll lose me, but gain an other reader, no problem. Add a page navigation section, with links to the headings on the page. It can be put before or after the introduction. Move the, useful, reference to the end. Thanks.
