6/29/2007 3:18:00 AM

 

Вышла первая версия ScriptDoc - инструмента, предназначенного для извлечения XML-комментариев из JavaScript-файлов для того, чтобы в дальнейшем можно было сгенерировать документацию с использованием того же SandCastle.

Документация выглядит точно так же, как и та, которая генерируется из C#-кода и точно так же, как документация в MSDN.

Утилита окажется полезной особенно тем ASP.NET-разработчикам, которые используют ASP.NET Ajax Framework.

Скачать ScriptDoc можно здесь.

10/10/2006 2:23:00 AM

Уже который раз встречаю попытки использовать SandCastle для создания документации к коду. Видел  на CodeProject несколько статей, видел даже специальный SandCastleBuilder...

Вот и сегодня наткнулся на заметку.

Я тоже пробовал запускать, переделывать бат-файл, использовать GUI, сделанный непонятно кем, но ленивым, чтобы батник не запускать :)

Однако, пока еще очень сыро.

В качестве хорошей альтернативы можно пользоваться NDoc. Версию, поддерживающую .NET 2.0 со всякими там Generics и т.д. можно найти тут: http://jonas.lagerblad.com/blog/?p=4

GUI там тоже прилагается.

В общем, у меня работает прекрасно - сгенеренной документацией дивелоперы, использующие мой API довольны.
Возможности расширения тоже есть, только ни разу не приходилось пользоваться :)

Powered by BlogEngine.NET 1.6.0.0

About the author

Alexey Raga Alexey Raga
.NET software developer.

E-mail me Send mail

Twitter


Disclaimer

The opinions expressed herein are my own personal opinions and do not represent my employer's view in anyway.

© Copyright 2010

Sign in