doc: move limitations to bottom
Add ToC
doc: change tag alignment.
doc: better documentation for options