Timeline for Are XML Comments Necessary Documentation?
Current License: CC BY-SA 3.0
2 events
| when toggle format | what | by | license | comment | |
|---|---|---|---|---|---|
| Oct 22, 2012 at 15:49 | comment | added | Dan Is Fiddling By Firelight | It's not just for when you don't have the source. If your editor can parse them (like Visual Studio does with Xml Comments), they can give information as mouseover/popups without requiring you to navigate to a different file. A 1 line range validator that limits an int to a narrower range is obvious when you go to the file where the setter is implemented; but having "FrobableID must be be between 0 and 1000" appear when you start typing "myFrobable.Fro..." and the autocomplete kicks in us a helpful reminder. | |
| Oct 22, 2012 at 14:44 | history | answered | Sergey Kalinichenko | CC BY-SA 3.0 |