Narzędzie do przypisywania kodu źródłowego

Question

Szukam narzędzia, za pomocą którego mogę opisać kod źródłowy.

Mam kod źródłowy 3-ty partia (JavaScript) Muszę zrozumieć i nie chcą go zmienić (dodać komentarze inline), tak że

• numery linii może pozostać w stanie nienaruszonym (do komunikacji z innymi),
• Mogę uniknąć przypadkowej zmiany czegoś i
• moje adnotacje wyróżniają się w porównaniu do komentarzy autorów.

Normalnie wydrukowałbym całą całość, ale kod jest za długi i muszę go udostępnić na e-mail. Byłbym świetny, gdyby ktoś mógł zrobić coś takiego, włączając w to możliwość tworzenia "połączeń" między takimi miejscami w kodzie, ewentualnie nawet wizualnie za pomocą linii lub strzał.

Answer 1

Jeśli zwykle byś go wydrukował (gdyby był krótszy), czemu by nie wydrukować go do pliku PDF, a następnie użyć przeglądarki PDF obsługującej komentarze, takie jak Foxit Reader? :)

Answer 2

Masz trudne wymagania. Nie znam takiego narzędzia. Niemniej jednak jako narzędzie o bardziej ogólnym celu mogę polecić Yui Doc (pobierz here).

Answer 3

Z pewnością możesz zrobić, co chcesz, dzięki LaTeX i pakietowi aukcji. Ale jeśli nie jesteś już użytkownikiem LaTeXa, możesz pomyśleć, że jest to trudna droga.

Answer 4

Zbuduję dla niego glamour browser. (Jeśli wydasz pół dnia budowy, to nie będzie za dużo).

[edycja] Glamour to zestaw narzędzi do tworzenia przeglądarek na modelu. Model składałby się z różnych części pliku (ów) oraz komentarzy i atrybutów, które chciałbyś dodać. Umożliwi to łatwą nawigację po źródle i komentarzach, aby wybrać tylko części z (lub bez) niektórych atrybutów. Jest video i slajdy. Official page, Source

Answer 5

Rozpocznij projekt github i umieść tam kod, github zawiera adnotacje umiejętności OOB.

Answer 6

Co powiesz na używanie google wave z serwerem składniowym (http://wave-samples-gallery.appspot.com/about_app?app_id=14008)?

Answer 7

Chciałbym użyć adresu e-mail do komentowania i pastebin do hostowania i zaznaczania @h@ linii z łączami w tekście wiadomości e-mail.
LUB
niektóre narzędzia code-review (jak codestricker lub reviewboard na przykład)