Apply Inline Documentation Standards for our code's comments

[acicovic]

Is your feature request related to a problem?

Not all of our code's comments are in compliance with the Inline Documentation Standards. For example, the standard suggests that PHP function comments should be in third person, which is not always the case in our code.

Describe the solution you'd like

Read the standards, see where we aren't in compliance with them and make any corrections needed.