diff --git a/doc/fluidsynth-v11-devdoc.txt b/doc/fluidsynth-v11-devdoc.txt
index 9316fa0e..bd3192df 100644
--- a/doc/fluidsynth-v11-devdoc.txt
+++ b/doc/fluidsynth-v11-devdoc.txt
@@ -70,7 +70,7 @@ What is FluidSynth?
 
 \section NewIn2_0_0 Whats new in 2.0.0?
 
-FluidSynths SOVERSION was bumped. The API was reworked, deprecated functions were removed. Functions that were doing (nearly) the same were fused together.
+FluidSynths SOVERSION was bumped. The API was reworked, deprecated functions were removed.
 
 Changes in FluidSynth 2.0.0 concerning developers:
 
@@ -90,7 +90,7 @@ Changes in FluidSynth 2.0.0 concerning developers:
 - remove struct _fluid_gen_t, fluid_gen_set_default_values() and enum fluid_gen_flags from public API
 - remove macros fluid_sfont_get_id() and fluid_sample_refcount() from public API
 - remove FLUID_NUM_MOD macro from public API
-- remove the following deprecated enum values:
+- remove the following deprecated enum values from public API:
   - GEN_LAST
   - LAST_LOG_LEVEL
   - FLUID_SEQ_LASTEVENT
@@ -99,7 +99,7 @@ Changes in FluidSynth 2.0.0 concerning developers:
 - all public \c fluid_settings_* functions that return an integer which is not meant to be interpreted as bool consistently return either FLUID_OK or FLUID_FAILED
 - all public delete_* functions return void and are safe when called with NULL
 - the shell command handler was decoupled internally, as a consequence the param list of new_fluid_server() and new_fluid_cmd_handler() was adapted
-- reverb: roomsize is now limited to an upper threshold of 1.0
+- reverb: roomsize is now limited to an upper threshold of 1.0 to avoid exponential volume increase
 - use unique device names for the "audio.portaudio.device" setting
 - rename fluid_mod_new() and fluid_mod_delete() to match naming conventions: new_fluid_mod() and delete_fluid_mod()
 <br /><br />