docs: fix syntax highlighting of code blocks

And various other cleanups

Change-Id: I240badc5358c09f006c2a22d4706ce373f2dd188
diff --git a/docs/release-notes/release-notes-0.3.4.rst b/docs/release-notes/release-notes-0.3.4.rst
index 822c4ff..62f56ba 100644
--- a/docs/release-notes/release-notes-0.3.4.rst
+++ b/docs/release-notes/release-notes-0.3.4.rst
@@ -5,10 +5,10 @@
 
 Changes since version 0.3.3:
 
-New features:
-^^^^^^^^^^^^^
+New features
+^^^^^^^^^^^^
 
-- Boolean Face property IsOnDemand has been replaced with multistate FacePersistency
+- The boolean Face property ``IsOnDemand`` has been replaced with multistate FacePersistency
   property (:issue:`2989`, :issue:`3018`): persistent (Face exists as long as there are no
   system or socket errors), on-demand (Face is removed after inactivity period), and
   permanent (Face exists unless explicitly destroyed by the management).
@@ -22,16 +22,8 @@
   Currently, changing the policy requires a minor change in NFD source code.
   Configuration interface is coming in the next release (:issue:`3148`)
 
-
-Updates and bug fixes:
-^^^^^^^^^^^^^^^^^^^^^^
-
-- Update of NDN Essential Tools to version 0.2 `<https://github.com/named-data/ndn-tools>`__
-  with code improvements and the following new tools:
-
-  * PIB service to manage the public information of keys and publish certificates
-    (:issue:`3018`)
-  * A Wireshark dissector for NDN packets (:issue:`3092`)
+Improvements and bug fixes
+^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 - RibManager constructor now accepts KeyChain as a parameter, preparing it for simplifying
   implementation with the new ``ndn::Dispatcher`` class (:issue:`2390`)
@@ -41,18 +33,18 @@
 - Enable automatic re-creation of multicast faces when network connectivity changes
   (:issue:`2460`)
 
-- Enhance exception throwing with Boost Exception library (:issue:`2541`)
+- Enhance exception throwing with the Boost Exception library (:issue:`2541`)
 
-Deprecated:
-^^^^^^^^^^^
+Deprecations
+^^^^^^^^^^^^
 
-- BroadcastStrategy (``/localhost/nfd/strategy/broadcast``) renamed as MulticastStrategy
+- BroadcastStrategy (``/localhost/nfd/strategy/broadcast``) renamed to MulticastStrategy
   (``/localhost/nfd/strategy/multicast``) (:issue:`3011`)
 
-Upcoming features (partially finished in development branches):
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Upcoming features (partially finished in development branches)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-- NDNLPv2 (http://redmine.named-data.net/projects/nfd/wiki/NDNLPv2, :issue:`2520`,
+- `NDNLPv2 <https://redmine.named-data.net/projects/nfd/wiki/NDNLPv2>`__ (:issue:`2520`,
   :issue:`2879`, :issue:`2763`, :issue:`2883`, :issue:`2841`, :issue:`2866`)
 
 - Refactored implementation of NFD management (:issue:`2200`, :issue:`2107`)