[I-03] NatSpec docs are incomplete

[madMax92221]

Some external methods are missing certain components from the NatSpec documentation such as @param and some methods are missing it completely. NatSpec documentation is essential for better understanding of the code by developers and auditors and is strongly recommended. Please refer to the NatSpec format and follow the guidelines outlined there.

[wankhede04]

fixed at commit f39e0bf