Updated documentation with more pragmatic information