Open jatin56 opened 5 years ago
A few guidelines for this issue:
For example, this is a useless docstring:
def add(x, y):
"""
add: method
adds two things
parameters: x, y
returns: number
"""
While I understand that your IDE might be doing this automatically for you please avoid the temptation to follow whatever your IDE tells you to do. A useful docstring/comment would be:
def some_fn():
...
total = cost + damages + repair + 1
# a comment explaining the significance of 1 and WHY we need it here
...
Comments like the following are also quiet useless:
x = a + b # add a and b and store in x
The code for the application is not properly documented. New members wanting to contribute to the Project may find Difficult to understand the code and may have to spend more time to understand the code rather than improving it.
Properly Documenting the code will be useful for people who want to contribute or learn from the code