DevForce Community Forum : Class Documentation http://www.ideablade.com/forum/ This is an XML content feed of; DevForce Community Forum : DevForce Classic : Class Documentation Thu, 11 Jun 2026 13:39:32 -700 Mon, 26 Nov 2007 18:04:31 -700 http://blogs.law.harvard.edu/tech/rss Web Wiz Forums 9.69 360 www.ideablade.com/forum/RSS_post_feed.asp?TID=364 DevForce Community Forum http://www.ideablade.com/forum/forum_images/IdeaBlade_logo_tm.png http://www.ideablade.com/forum/ Class Documentation : Capturing the Description field... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=2012#2012 Author: eileenv
Subject: 364
Posted: 26-Nov-2007 at 6:04pm

Capturing the Description field from the database table is currently on our Features list. As we are working on our next generation Object Mapper, this feature will most likely be made available in version 4.x.



Edited by eileenv - 26-Nov-2007 at 6:11pm]]> Mon, 26 Nov 2007 18:04:31 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=2012#2012 Class Documentation : I like the idea of being able... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=2006#2006 Author: rclarke
Subject: 364
Posted: 25-Nov-2007 at 8:34am

I like the idea of being able to add a commnt for a property in the mapper but I think that the initial comment should be derrived from the database description field for the column. This way database documentation tools that produce documentation would still work and the same comments could be captured by the mapper and the programmer could augment or replace the comments in the mapper.
 
BTW, would you consider making your 'ORM Documentor' available?
]]> Sun, 25 Nov 2007 08:34:18 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=2006#2006 Class Documentation : We've developed an 'orm... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1999#1999 Author: jforgan
Subject: 364
Posted: 22-Nov-2007 at 2:39pm

 
We've developed an 'orm documentor' app which reads the DevForce .orm file and generates all the overrides and puts them in a .cs file. It generates complete 'skeleton' classes which include the property and relation property definitions along with comment sections.
 
We then include the .cs file in our solution and edit it to add the comments to each property.
 
If we re-run our documentor we can point it to our existing .cs file so that it picks up any existing comments and includes them against the relevant property when the file is regenerated.
 
At the very least it would be great if the ORM allowed you to define a comment against a property. Would seem to be a fairly simple enhancment because it's just some text that gets saved away in the .orm xml file - no validation required!
 
 
]]> Thu, 22 Nov 2007 14:39:21 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1999#1999 Class Documentation : Yes, that would be wonderful if... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1468#1468 Author: m2r4miller
Subject: 364
Posted: 05-Oct-2007 at 8:32am

Yes, that would be wonderful if they would capture the Description property of the table in comments as I use that property alot in my database designs.
 
We can hope, eh?
]]> Fri, 05 Oct 2007 08:32:12 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1468#1468 Class Documentation : Mark, I guess my original message... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1448#1448 Author: rclarke
Subject: 364
Posted: 04-Oct-2007 at 2:16pm

Mark,
I guess my original message was not clear. I know how to use Sandcastle. I would like to have a way to use Sandcastle to document properties within entities. The only way I know how to do this is to override every property in the final class just for purposes of adding the XML comments. What would be really cool is if Ideablade could capture the database column description and generate an XML comment in the <Entity>DataRow class for each property.
]]> Thu, 04 Oct 2007 14:16:30 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1448#1448 Class Documentation : Download and install the following: 1.... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1134#1134 Author: m2r4miller
Subject: 364
Posted: 10-Sep-2007 at 9:43am

Download and install the following:
1. HTML Help workshop: http://msdn2.microsoft.com/en-us/library/ms669985.aspx
2. Sandcastle June CTP: http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en
3. Sandcastle Help File Builder GUI tool: http://www.codeplex.com/SHFB
 
In Visual Studio 2005, right click your Model project, select Properties, then the Build tab, and check the XML Documentation File box in the Output section.
 
Next Build your Model project, and run the Sandcastle GUI. Select the Model.XML in the \bin\debug|release folder and build the file.
 
It takes a while, but works very well.
 
-Mark
]]> Mon, 10 Sep 2007 09:43:22 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=1134#1134 Class Documentation : I would like to use Sandcastle... http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=897#897 Author: rclarke
Subject: 364
Posted: 09-Aug-2007 at 8:16am

I would like to use Sandcastle to provide documentation for my model classes. The only way I see to do this is to override each property in the final class which is a lot of additional work and I'm not so sure it's a good idea anyway. Unless I'm missing something, there is no other quick way to do it. If anyone has any ideas please post them.
 
 
]]> Thu, 09 Aug 2007 08:16:24 -700 http://www.ideablade.com/forum/forum_posts.asp?TID=364&PID=897#897