documentation - metas - generador de metatags para blogger

¿Cómo puedo averiguar qué está causando diferencias en los documentos generados de Sandcastle?

Question

En Noda Time, generamos nuestra documentación utilizando Sandcastle y SHFB . Luego devolvemos la documentación al repositorio de origen, principalmente porque eso facilita la visualización de los documentos más recientes (e históricos).

Soy el desarrollador principal del proyecto, pero uso dos computadoras, y desafortunadamente, en este momento están creando documentación diferente, aunque ambas están actualizadas en la misma fuente.

Las dos computadoras son iguales en todas las formas importantes que puedo pensar:

• Castillo de arena 2.7.2.0
• SHFB 1.9.6.0
• VS 2012 Professional (ambas reportaron la versión 11.0.50727.1 en "Programas", ambas "Versión 11.0.51106.01 Actualización 1" en la página "Acerca de")
• Versión más reciente del contenido de ayuda local para .NET Framework 4.5 (y ningún contenido de ayuda local para otras versiones del marco)

Pasos tomados para asegurar una construcción limpia:

• Se eliminó la carpeta de caché SHFB ( C:/Users/Jon/AppData/Local/EWSoftware/Sandcastle Help File Builder/Cache )
• Se eliminó la carpeta en la que se genera la documentación.
• Se eliminó el archivo de configuración del usuario relacionado con el archivo de proyecto SHFB.
• Eliminado el caché de símbolos en Visual Studio

Aún quedan las diferencias. Parecen estar limitados a la documentación heredada de MSDN, en particular, Object.Finalize .

Versión 1 (generada en la máquina "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>

Versión 2 (generada en la máquina "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 operations
   before the <a href="http://msdn2.microsoft.com/en-us/library/e5kfa45b" 
   target="_blank">Object</a> is reclaimed by garbage collection.</div>

Ambos enlaces a la misma documentación de MSDN, que se parece a la versión 1 (sin enlaces a Object ).

Al observar algunos de los archivos modificados, el cambio es consistente y está restringido a este miembro.

¿De dónde podría obtener Sandcastle esta documentación y cómo puedo lograr que ambas computadoras se comporten de la misma manera?

EDITAR: Un fragmento más de información: después de limpiar la memoria caché y reconstruir los documentos en ambas máquinas, hay tres archivos en el directorio de la caché SHFB:

• Reflection.cache tiene el mismo tamaño en ambas máquinas
• MsdnUrl.cache tiene el mismo tamaño en ambas máquinas
• .NETFramework_4.0.0319_E8879A28.cache tiene un tamaño de 13,377,733 bytes en Chubby, y 13,337,949 bytes en Sandy

EDITAR: progreso significativo! He encontrado de dónde viene la diferencia probablemente ...

El archivo c:/Windows/Microsoft.NET/Framework/v2.0.50727/en/mscorlib.xml :

• On Chubby tiene 8,005,263 bytes con fecha del 12 de diciembre de 2011 y tiene el texto no vinculado para Finalize
• En Sandy tiene 9,740,370 bytes con fecha del 31 de agosto de 2009, y tiene el texto para Finalize que incluye enlaces

En ambas máquinas, mscorlib.dll tiene el mismo tamaño (4,550,656 bytes) y tiene una fecha de modificación del 13 de septiembre de 2012.

Pero, ¿cómo puedo conseguir que sean iguales? ¿De dónde viene esa diferencia? (¿Paquetes de servicio?)

EDIT: De acuerdo, la versión en c:/Windows era una pista falsa, es la versión en c:/Program Files (x86)/Reference Assemblies/Microsoft/Framework que es la culpa. Voy a ver si puedo averiguar por qué eso podría ser diferente entre las instalaciones ...

Answer 1

Un par de ideas considerando tus ediciones recientes, aunque estoy de acuerdo en que es un poco disparar en la oscuridad ...

Usaría una herramienta como "Más allá de la comparación" para comparar los archivos .Net Framework y los archivos XML en ambas máquinas (perfil de "comparación de carpeta") Favorece la comparación de niveles binarios para estar perfectamente seguro ... si ambas máquinas son locales, debería ser muy rápida.

También puede intentar ejecutar el Monitor de proceso de Mark Russinovich ( http://live.sysinternals.com/procmon.exe ) en ambas máquinas y ejecutar el proceso de creación de documentación. De esta manera, verá qué archivos se leen y participan en el proceso de creación del archivo de ayuda, y de dónde provienen ... Obtendrá una gran cantidad de resultados ya que mostrará todo lo que sucede en su sistema; es posible que desee deshabilitar el registro y la supervisión de la red, dejar solo la supervisión de archivos y también excluir cualquier proceso no relacionado con el proceso de creación de documentación.

No soy un experto en generación de ayuda, pero creo que el texto proviene de los archivos XML, por lo que es posible que desee poner un filtro que solo muestre los archivos xml.

Si puede identificar los archivos involucrados, es posible que deba copiarlos de una máquina a otra.