Table on documentation

Jun 14, 2008 at 5:19 PM
Edited Jun 14, 2008 at 5:33 PM
Hi, All...

It must be pretty stupid but I'm working on it for some time and I need some pair of fresh eyes to see the solutions. :-\

I have a documentation that uses the new Conceptual Content (that are XML files processed through SHFB or SandCastle) and there I use a table with the following syntax:
<table>
 <tableHeader>
 <row>
 <entry>Header 1</entry>
 <entry>Header 2</entry>
 </row>
 </tableHeader>
 <row>
 <entry>Column 1</entry>
 <entry>Column 2</entry>
 </row>
</table>
Wich renders pretty and nicely in the Prototype style.

However, when I use the same syntax in the code documentation, as in:
/// <table>
/// <tableHeader>
/// <row>
/// <entry>Header 1</entry>
/// <entry>Header 2</entry>
/// </row>
/// </tableHeader>
/// <row>
/// <entry>Column 1</entry>
/// <entry>Column 2</entry>
/// </row>

all I get is a jumble of text with no formatting at all...

Can anyone tell me what I'm doing wrong here?

Yes, I know I can use HTML in the code documentation, but I'd like the same formatting I get within the Conceptual Content.

Regards.
Jun 14, 2008 at 5:50 PM
Edited Jun 14, 2008 at 5:52 PM
OK All... never mind my STOOPID question...

All I needed to do was to add an class="authoredTable" and I got my pretty table.

I told ya it was stupid.
Coordinator
Jun 14, 2008 at 6:33 PM
The table tags aren't supported in XML comments, they are MAML (conceptual content) only.  If they are getting processed, it's most likely by accident because they're in one of the shared transforms.  You can use a <list> element with a type="table" attribute to get a table layout in XML comments.  That will get the same layout and formatting (or close to it) as in the conceptual content.

Eric
Jun 15, 2008 at 2:25 AM
What I meant above was that all I needed to do was to add the class="authoredTable" on an HTML table.

Sorry for the confusion.