update text based on review

Author: jessica-mitchell

models/aeif_cond_alpha.h

@@ -107,11 +107,10 @@ For the reference implementation of this model, see
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_cond_alpha_astro.h

@@ -114,11 +114,10 @@ model, see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_cond_alpha_multisynapse.h

@@ -99,11 +99,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_cond_beta_multisynapse.h

@@ -116,11 +116,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_cond_exp.h

@@ -109,11 +109,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 
 Parameters:

models/aeif_psc_alpha.h

@@ -98,11 +98,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_psc_delta.h

@@ -100,11 +100,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_psc_delta_clopath.h

@@ -96,11 +96,10 @@ See also [2]_.
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [4]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [4]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++

models/aeif_psc_exp.h

@@ -98,11 +98,10 @@ For implementation details see the
 .. note::
 
     The default refractory period for ``aeif`` models is zero, consistent with the model definition in
-    Brette & Gerstner [1]_.
-    This means if the refractory period is zero, the ``aeif`` neurons can fire multiple spikes in a single time step,
-    which can lead to exploding spike numbers and extreme slow-down of simulations.
+    Brette & Gerstner [1]_.  Thus, an ``aeif`` neuron with default parameters can fire multiple spikes in a single
+    time step, which can lead to exploding spike numbers and extreme slow-down of simulations.
 
-    We recommend users set ``t_ref > 0``.
+    To avoid such unphysiological behavior, you should set a refractory time ``t_ref > 0``.
 
 Parameters
 ++++++++++