fix highlighting for relnotes
fix formatting for method description
more markup fixes
fix :bb:step: reference
add space to make directive recognizable
fix parameter markup
Merge sa2ajj/buildbot:more-docs-fixes (PR #1174)