In Noda Time, we generate our documentation using Sandcastle and SHFB. We then commit the documentation back into the source repository - primarily because that makes it easy to view the latest (and historical) docs.

I'm the primary developer for the project, but I use two computers - and unfortunately, at the moment they're building different documentation even though they're both updated to the same source.

The two computers are the same in every important way I can think of:

  • Sandcastle 2.7.2.0
  • SHFB 1.9.6.0
  • VS 2012 Professional (both reported version 11.0.50727.1 in "Programs", both "Version 11.0.51106.01 Update 1" in the "About" page)
  • Latest version of local help content for .NET Framework 4.5 (and no local help content for other framework versions)

Steps taken to ensure a clean build:

  • Deleted the SHFB cache folder (C:\Users\Jon\AppData\Local\EWSoftware\Sandcastle Help File Builder\Cache)
  • Deleted the folder the documentation is generated into
  • Deleted the user settings file related to the SHFB project file
  • Deleted the symbol cache in Visual Studio

Still the differences remain. They appear to be limited to documentation inherited from MSDN itself, in particular Object.Finalize.

Version 1 (generated on machine "Chubby"):

<div class="summary">Allows an object to try to free resources and perform
other cleanup operations before it is reclaimed by garbage collection.</div>

Version 2 (generated on machine "Sandy"):

<div class="summary">Allows an <a 
   href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" target="_blank">
   Object</a> to attempt to free resources and perform other cleanup o
documentation sandcastle finalize shfb
Edit
Report