Just for the sake of reference, I though I should document what I ended up doing.
Basically, I just created a new .cs
file for each namespace I had (for example, FooDoc.cs
for the Foo
namespace), and formatted my code like so:
// <copyright file="FooDoc.cs" company="Bar Company">
// Copyright (c) 2013 Bar Company. All rights reserved.
// </copyright>
namespace Foo
{
/// <summary>
/// Documentation here.
/// </summary>
[System.Runtime.CompilerServices.CompilerGenerated]
internal class FooDoc
{
}
}
It's a little on the hackish side, since I'm basically adding an extra file just to document my namespaces, but it does let me keep my documentation 100% within the project and Sandcastle-compatible without upsetting either Stylecop or other code analysis tools that I've been using.