docs: fix syntax highlighting of code blocks

And various other cleanups

Change-Id: I240badc5358c09f006c2a22d4706ce373f2dd188
diff --git a/docs/release-notes/release-notes-0.3.2.rst b/docs/release-notes/release-notes-0.3.2.rst
index c785ccb..1506c3a 100644
--- a/docs/release-notes/release-notes-0.3.2.rst
+++ b/docs/release-notes/release-notes-0.3.2.rst
@@ -5,8 +5,8 @@
 
 Changes since version 0.3.1:
 
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
 
 - **Tables**
 
@@ -16,8 +16,8 @@
 
   * Perform FIB updates before modifying RIB (:issue:`1941`)
 
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 - **Documentation**
 
@@ -30,7 +30,7 @@
 
   * Refactor channel acceptors to avoid use of shared pointers (:issue:`2613`)
 
-  * Refactor code to avoid deprecated `Block::fromBuffer` overloads (:issue:`2553`)
+  * Refactor code to avoid deprecated ``Block::fromBuffer`` overloads (:issue:`2553`)
 
   * Refactor code to use move semantics for sockets where possible (:issue:`2613`)
 
@@ -48,7 +48,7 @@
 
 - **Tools**
 
-  * Fix hanging of `nfdc` on wrong input (:issue:`2690`)
+  * Fix hanging of ``nfdc`` on wrong input (:issue:`2690`)
 
 - **Build**
 
@@ -62,7 +62,7 @@
 
   * Use C version of snprintf (:issue:`2299`)
 
-  * Emulate `std::to_string` when it is missing (:issue:`2299`)
+  * Emulate ``std::to_string`` when it is missing (:issue:`2299`)
 
   * Fix several "defined but not used" warnings with gcc-5 (:issue:`2767`)