Herramienta de anotación de código fuente

Question

Estoy buscando una herramienta con la que pueda anotar el código fuente.

que tienen algo de código fuente de tercera parte (JavaScript) lo necesario para comprender y no quiero cambiarlo (añadir comentarios en línea) para que

• números de línea pueden permanecer intactos (para la comunicación con los demás),
• Puedo evitar cambiar accidentalmente algo y
• mis anotaciones se destacan en comparación con los comentarios de los autores.

Normalmente me gustaría imprimir todo un garabato, pero el código es demasiado largo para eso y tengo que compartirlo por correo electrónico. Sería genial si uno pudiera hacer algo así, incluyendo poder crear "enlaces" entre los lugares en el código, posiblemente incluso visualmente con líneas o flechas.

Answer 1

Si normalmente lo imprime (si fuera más corto), ¿por qué no imprimirlo en un PDF y luego usar un visor de PDF que admita comentarios, como Foxit Reader? :)

Answer 2

Tiene requisitos difíciles. No sé de tal herramienta. Sin embargo, como una herramienta más general, puedo recomendar Yui Doc (descargue here).

Answer 3

Sin duda puede hacer lo que quiera con LaTeX y su paquete de listados. Pero si aún no eres usuario de LaTeX, podrías pensar que es una tarea difícil.

Answer 4

Construiría un glamour browser para él. (Si pasa medio día construyendo, no sería demasiado).

[editar] Glamour es un conjunto de herramientas para construir navegadores en un modelo. El modelo aquí consistiría en las diversas partes del archivo (s) y los comentarios y atributos que desea agregar. Esto le permitiría navegar fácilmente a través de la fuente y los comentarios, para seleccionar solo partes con (o sin) ciertos atributos. Hay un video y diapositivas. Official page, Source

Answer 5

iniciar un proyecto github y publicar el código allí, github incluye las capacidades de anotación OOB.

Answer 6

¿Qué tal si utilizamos la ola de Google con sintaxis (http://wave-samples-gallery.appspot.com/about_app?app_id=14008) bot?

Answer 7

Me gustaría utilizar el correo electrónico para comentar y pastebin para alojar y resaltar @h@ líneas con enlaces en el texto del correo electrónico.
O
alguna herramienta de código de revisión (como codestricker o reviewboard por ejemplo)