Here are some questions / issues with the documentation for NAnt.
1. The documentation for the <xmlpoke> tasks states, "The location specified by the XPath _expression_ must exist, it will not create the parent elements for you. However, provided you have a root element you could use a series of the tasks to build the XML file up if necessary." I have played with this task and haven't found a way to get it to create any element or attribute. It certainly sets the values if they exists, but the statement, "provided you have a root element you could use a series of the tasks to build the XML file up if necessary" does not seem accurate.
2. The examples for the <if> task all demonstrate deprecated attributes. There is no example for the new "test" attribute. Also, this would seem a natural place for link into expressions and functions rather than forcing developers to go back to the main index page. I would also consider a link from the "if" and "unless" attributes for all tasks provided this isn't too difficult.
3. _expression_ section 4.2.4 "Devide" should be "Divide".
4. Your documentation generator makes it easy to see what tasks and attributes are deprecated. However, there is no assistance in finding out how to re-implement the functionality with new features. For instance, documentation for the <available> task clearly indicates that it is deprecated, but does not point you to the functions that you might use to replace this task such as directory::exists or file::exists.
Thanks,
Tom
