make doc ref example match the reSt standards
Merge pull request #2925 from xabbuh/fix-rest-example-standard

make doc ref example match the reSt standards