minor updates

- include citations
- improve documentation