Corrections to render sphinx correctly

[TimDaub]

I took a look to see how they render via ReadTheDocs. It seems Sphinx got confused with how to render the Parameters and Status Codes.

Thx @ttmc, I should have checked the rendered output :/ (I did this time!)

[codecov-io]

Current coverage is 96.85% (diff: 100%)

Merging #819 into master will not change coverage

@@             master       #819   diff @@
==========================================
  Files            26         26          
  Lines          1683       1683          
  Methods           0          0          
  Messages          0          0          
  Branches          0          0          
==========================================
  Hits           1630       1630          
  Misses           53         53          
  Partials          0          0          

Powered by Codecov. Last update 57d9374...5ef5329

[ttmc]

This time I checked out the branch and rendered it locally just to see what happens. The Parameters and Status codes render fine now.

I also noticed it fails to syntax-highlight the final example response (HTTP). Sphinx gave the warning:

/home/troy/repos/bigchaindb/docs/server/source/drivers-clients/http-client-server-api.rst:316: WARNING: Could not lex literal_block as "http". Highlighting skipped.

I honestly don't see what's wrong or different from previous example HTTP response blocks. I'm not sure it matters that much though. I'd be okay with merging as is.