Doc/additions to user documentation

@alexey-rise are you covering for @rodrigopavezi if so can you review. One new page to user documentation and a few minor changes to existing docs