fix: broken links in doc

[demeringo]

• fixes https://github.com/Boavizta/Tools-API/issues/37
• use standard markdown format for lists
• fixes https://github.com/Boavizta/Tools-API/issues/38
• update local documentation setup instructions (missing package for swagger)

[demeringo]

Hi @da-ekchajzer, a couple of small fixes on the doc. Please let me know if it looks good to you.

[da-ekchajzer]

Thanks for the PR everything look good it's merge. I will add some elements to the swagger (example, description, ...) to look more like a demo.