-
Notifications
You must be signed in to change notification settings - Fork 0
/
StandardComments.txt
61 lines (51 loc) · 1.49 KB
/
StandardComments.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
Last Update: Ryan Taylor 2016/03/03
Use these standard comments when creating your code.
For complete coverage we should be not only adding comments on the class,
but also on the METHOD HEADER for each public method in those classes.
Any CSharp class files you create:
place starting on first line of file.
/// <summary>
/// Your Name
/// Created: yyyy/mm/dd
///
/// Actual summary of the class if needed, example is for DTO
/// Class for the creation of User Objects with set data fields
/// </summary>
///
/// <remarks>
/// Updater Name
/// Updated: yyyy/mm/dd
/// </remarks>
using....
Standard Presentation layer METHOD HEADER comments:
/// <summary>
/// Your Name
/// Created: yyyy/mm/dd
///
/// Actual summary of the class if needed.
/// </summary>
///
/// <remarks>
/// Updater Name
/// Updated: yyyy/mm/dd
/// example: Fixed a problem when user inputs bad data
/// </remarks>
/// <param name="sender"></param>
/// <param name="e"></param>
public bool ExampleMethod()...
Standard DAL/BLL METHOD HEADER commenting:
/// <summary>
/// Your Name
/// Created: yyyy/mm/dd
///
/// Actual summary of the class.
/// </summary>
///
/// <remarks>
/// Updater Name
/// Updated: yyyy/mm/dd
/// example: Fixed a problem when user inputs bad data
/// </remarks>
/// <param name="paramName">A description of the parameter that this method takes</param>
/// <exception cref="SQLException">Insert Fails (example of exception tag)</exception>
/// <returns>Rows edited</returns>