By this I am referring to both the documentation as well as the documentation generator.
The former isn't so bad, it's definitely enough to get by; But it would probably help new adopters, and especially those looking to get really in-depth if things were documented a bit more. For instance, the macro page is missing quite a few pretty important sections, and I frequently have to just print the AST in a sample program just to see how things are represented.
The latter is my main problem. First, I'm not a fan of RST, I much prefer markdown and in fact had never seen RST before coming to Nimrod. Might I ask why this was chosen as the default? And second, the pages produced aren't all that "pretty". ASAIK there is no referencing other documented functions/types, the side panel is an absolute mess - no alphabetic ordering, no sectioning, just simply no organization beyond type/proc/macro/template. While I understand it's extremely basic and alpha still, it's just so far behind something like rust's let alone something mature such as Doxygen. And my final complain with the docgen tool is that (last time I used it, which admittedly was a while ago) it refused to document my whole project, regardless of the flags I passed it. It would just do my main module, then die.
But yes, filwit works on improving the docs. Also the compiler will be split up into multiple tools, idetools and doc2 will be extracted so that people can improve them more easily.
But yes, filwit works on improving the docs.
Just touching bases, as it's been awhile since I've been around. I'm actively working on this when I have time, and will try to dedicate more time coming up. Please bare with me as some significant stuff in my life has been changing around recently. I just made a major move across country (Florida to Oregon) and the 3,100+ mile trip took us a week on the road alone.
I've setup here in Oregon now and things are stabilizing for me, but I'm still juggling a few (financially relevant) things around which require my immediate attention. Reconnecting with friends and family is currently burning the little free-time I have, and prior to the move I was dedicating most of my "nimrod hours" to developing my engine (which is still planned for release, in an early state, around the end of the year). So the docs have been somewhat on the back-burner for awhile now, and it will probably be another few weeks until I have more to show.
Sorry for the delays everyone, but life has some unexpected hurdles sometimes. Will get on the IRC soon now that I'm connected to the webs again.