Świetną sprawą jest możliwość tworzenia dokumentacji do kodu. Do tego służy świetnie Sandcastle zrobione przez Microsoft. Nie testowałem tego jeszcze na Viście, ale na XP działa rewelacyjnie. I warto się temu bliżej przyjżeć.

Do kompilacji potrzebny jest sam Sandcastle, w miarę nowa wersja windows installera i GUI do Sandcastle.

Pracuje się na tym naprawdę świetnie i bardzo wygodnie. Ważne jest, żeby mniej więcej zaczaić jakich tagów w kodzie używać, żeby to miało ręce i nogi potem podczas tworzenia dokumentacji. Ale potem wszystko jest naprawdę cacy. Serdecznie polecam do tworzenia dokumentacji do kodu.

Potrzebne rzeczy do zainstalowania, żeby generator dokumentacji działał są opisane tutaj : http://www.ewoodruff.us/shfbdocs/Index.aspx?topic=html/8c0c97d0-c968-4c15-9fe9-e8f3a443c50a.htm

Strona do GUI : http://www.codeplex.com/SHFB

tagi stosowane przy tworzeniu dokumentacji do kodu opisane są tutaj : http://msdn.microsoft.com/en-us/library/5ast78ax.aspx

Naprawdę warto przynajmniej na to spojrzeć

Napisz komentarz

*
*