doc fixes by Pau Amma
reflect changes
Merge branch 'docs/fixes'