Add function docs formatting support

[SupunS]

Work towards #339

Description

Add function documentation formatting support.

• Extracting param and return type info
  • Parameters must follow the format: @param paramName: Param description
  • Return type must follow the format: @return The return type description
  • Tagging using @ follows the same approach as solidity, kotlin and java
• Removes leading and trailing whitespaces.
• Preserves at most one blank line in the middle of docs in the generated md file.

---

• Targeted PR against master branch
• Linked to Github issue with discussion and accepted design OR link to spec that describes this work
• Code follows the standards mentioned here
• Updated relevant documentation
• Re-reviewed Files changed in the Github PR explorer
• Added appropriate labels

[turbolent]

Nice!

[codecov-commenter]

Codecov Report

Merging #938 (c5dc140) into master (1c06d00) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #938   +/-   ##
=======================================
  Coverage   74.05%   74.05%           
=======================================
  Files         269      269           
  Lines       33082    33082           
=======================================
  Hits        24500    24500           
  Misses       7453     7453           
  Partials     1129     1129           

Flag	Coverage Δ
unittests	74.05% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1c06d00...c5dc140. Read the comment docs.