I have read questions like this: Are unit tests really used as documentation?
With regards to code comments; my research so far is telling me:
1) Some developers do not like any code comments and prefer to read unit test code method names to understand the code.
2) Some developers prefer code comments and unit test method names to understand the code
I have used the Sandcastle documentation tool to document my project API. I am debating whether to use Sandcastle to generate .HTML files for my Unit Tests project so someone else who reads them understands them more quickly. Is this necessary or a complete overkill? My gut is telling me - document the API with code comments, but do not document the actual test project.
The reason I ask is because I read a question on here yesterday where a user was talking about documenting the test project by explaining what each test does in more detail using Sandcastle.