XML <include> for documentation
I detest writing consumer targeted documentation in code, but if I want to use VS it seems I don't have a choice. Where would I prefer to write it - in the object browser, after all it documents the object (or at least it should), not the code.
I want to use the XML <include> feature, however it seems to require that I specify an absolute path for the file - which a) is long and b) restrictive. I would prefer to direct the preprocessor to the file via the class resources - is there some way I can do this. The XPath also gets quite long, and generally only the last part is significant - is there a way of symbolising it a'la HKCU etc in the Registry.
An advantage of externalising the consumer doco is that apart from focusing on the consumer I can also introduce reuse into the documentation via the use of "standard" blocks.
