doc improvements

- add description
- semicolons at the end of sql commands
- hyperlink related repos
- improved readability
- add contribution clause