make README.md clear for the first time

[arnaudjuracek]

• add link to ghp repo when mentioning it
• add #usage with detail on npm run commands

[pqml]

Closed. README has never been clear.

[leoternoir]

The basepath mumbo jumbo is rather unclear, coul it be clarified ?