Практически в любом первом-втором занятие по программированию (языку программирования) говорят о комментировании. По случаю, собрала ссылки для студентов по XML-комментариям в C#-коде. Немного, но вполне представительно.
Сначала общее, об оформлении кода в принципе:
C#
Coding Conventions (C# Programming Guide) (https://msdn.microsoft.com/en-us/library/ff926074.aspx)
Русскоязычные источники [RU]
Статья с хабра: XML документация в C# (http://habrahabr.ru/post/41514/) и ссылки из комментариев к этой статьи (для особенно ленивых):
- Почему нет многострочного варианта XML-комментариев? (http://rsdn.ru/article/devtools/CSxmlcmnt.xml)
- GhostDoc. Simplify your XML Comments! (http://submain.com/products/ghostdoc.aspx)
Англоязычные источники [EN]
Understanding
C#: XML Comments (http://broadcast.oreilly.com/2010/06/understanding-c-xml-comments.html)
XML
Documentation Comments (C# Programming Guide) (https://msdn.microsoft.com/en-us/library/b2s063f7.aspx)
Soft
Sandcastle -
Documentation Compiler for Managed Class Libraries
(http://sandcastle.codeplex.com/)