Найдено результатов: 3

.Net XML комментарий к документации API

Существует ли простой способ создать документацию в стиле MSDN из выходных данных Visual Studio XML?
Я не настолько терпелив, чтобы создать хороший xslt для этого, потому что я знаю, что я не первый человек, который пересек этот мост.

Кроме того, я недавно пытался установить замок из песка, но это действительно заставило меня скосить глаза. Либо я упустил что-то важное в этом процессе, либо он просто слишком вовлечен.

Я знаю, что у кого-то там есть действительно хорошее мертвое простое решение.

Я повторяю здесь, потому что я думаю, что мое форматирование сделало этот абзац неинтересным для чтения:

Я дал Сэнд-Кастлу попробовать, но мне было очень трудно его настроить. На самом деле я имею в виду нечто гораздо более простое.

То есть, если только я просто не понимаю процесс создания песчаного замка. Мне казалось, что это ужасно много дополнительного багажа, чтобы просто произвести что-то хорошее для тестировщиков, чтобы работать с ними.

visual-studio   xslt   documentation   sandcastle   xml-comments    

583   6   16:03, 1st July, 2020


Как заставить разработчиков использовать wiki

Я работаю над сложным приложением, где разные команды работают над своими собственными модулями со степенью перекрытия. Некоторое время назад мы создали экземпляр Mediawiki, частично по моей просьбе. У меня есть тяжелая работа, чтобы люди действительно использовали его, не говоря уже о том, чтобы внести свой вклад.

Я вижу много пользы в обмене информацией. Это может, по крайней мере, сократить время, когда мы изобретаем колесо.

wiki не очень структурирован, но я не уверен, что это проблема, пока вы можете искать то, что вам нужно.

Какие-нибудь намеки?

documentation   wiki   mediawiki    

447   13   14:50, 7th August, 2020


Генератор шаблона документации

У меня есть большая кодовая база без Javadoc, и я хочу запустить программу для написания скелета с основной информацией Javadoc (например, для параметра каждого метода write @param...),, поэтому мне просто нужно заполнить оставшиеся пробелы.

Кто-нибудь знает хорошее решение для этого?

Редактировать:

JAutodoc - это то, что я искал. Он имеет Ant задач, плагин Eclipse и использует скорость для определения шаблона.

java   documentation   javadoc    

467   6   03:17, 16th August, 2020