Здравствуйте, Alexander G, Вы писали:
AG>Вот здесьАвтор: MxMsk
Дата: 24.10.08
Вопрос: Как частно и полностью ли пишите XML-комментарии в C#?
увидел голосование про комментарии.
Во блин
А я вначале как раз хотел тему создать, потом решил просто голосовалку.
Сейчас я пишу везде, но заметил, что немногие так делают.
AG>Проголосовал за последний вариант, желаю объяснить позицию.
AG>Лучшая документация — это сам код. Комментарии для документации читаются не только в документации, но и в коде.
AG>Т.к. документация пишется в комментарии, "DSL" для неё имеет только одно техническое требование: чтобы оставался комментарием в соответствующем языке. Чем проще и читабельнее, тем лучше.
AG>Вот пример правильного комментария для документации.
AG>http://java.sun.com/j2se/javadoc/writingdoccomments/#format
AG>Можно ещё упростить: вместо @param p1 использовать @p1 и писать менее развёрнуто.
AG>XML же просто замусоривает код своим синтаксическим оверхедом, он не самый лучший язык разметки для данного случая. Convert absloutely everything to XML ?
Описание при помоще XML позволяет сделать удобный intelliscence, а также может быть использован для автоматической генерации help'ов