How to use XML documentation files

Question

1. When using an external assembly which comes with an XML documentation file, how do I get visual studio to find it?

2. When having an XML documentation file, is there a program or xml transform file or something I can use to look at it in a nice way? Not necessarily as complex as the msdn documentation viewer thingy, but at least something nicer than the pure xml...

Answer 1

Answer to your first question: the xml should have the same name as the assembly and be right next to it. So if you have an assembly called Svish.dll then your documentation file should be Svish.xml and be in the same directory.

Answer 2

1: you simply drop it in the same folder as the dll

2: does it need to be persisted? For "live" use, both the VS IDE and "reflector" allow you to review the documentation (against the types/members/etc). There are tools to transform it, but I've never bothered. Sandcastle may be worth a look, but it was never nice to me ;-p

Answer 3

1) The documentation file must have the same name as the assembly name, with the added extension '.xml', and reside in the same directory as its corresponding assembly. So for example, you have an 'MyCompany.MyNamespace.dll' and a 'MyCompany.MyNamespace.dll.xml' file in the same directory.

2) NDOC can generate some dirrent formats of documentation.