- more readable in markdown
- remove confusing stuff
- linkification
- rewording
- move parameter documentation to parameter documentation