0

Merge content files?

KChew

05 December 2007 07:48

None

Follow

Hi

In my workflow I am editing XML comments in the code of a VB.NET project using the Document! X plug-in, and adding and maintaining examples in a separate content file (this is meant to prevent the code from bloating).

I am wondering what I can/should do when new components are added to the source code. For example, if a developer adds a new method, this method will not be added to the existing content file ... will it? Therefore, do I have to add a new content file whenever the VB.NET projects gains or loses members? Is there a way to avoid this by merging content files?

Thanks for your suggestions!

• Facebook
• Twitter
• LinkedIn

3 comments

• 0
  
  Permanently deleted user 05 December 2007 17:05

  Content Files will always show the most up to date content of the item you are documenting - no structural information is stored, only the content you create. Let me know if you need any more information.

• 0
  
  KChew 06 December 2007 02:59

  Thanks. In that case, what happens if an item for which I have created content in the content file -- for example a method -- is removed from the project? Is the content still in the content file, but not published in the generated help? Or is the content lost?

• 0
  
  Permanently deleted user 06 December 2007 03:22

  If you remove (or rename) any member for which you have content defined, then the next time you open the Content File Document! X will prompt you to re-assign or discard the content (on an 'Orphaned Content' dialog).