diff --git a/NeuroML2/isopotential_LEMS.xml b/NeuroML2/isopotential_LEMS.xml
index 72c327d..e2cee26 100644
--- a/NeuroML2/isopotential_LEMS.xml
+++ b/NeuroML2/isopotential_LEMS.xml
@@ -3,15 +3,11 @@
       xsi:schemaLocation="http://www.neuroml.org/lems/0.7.3 LEMS_v0.7.3.xsd">
 
 
-    <!-- Work in progress - this is NOT intended for public use yet -->
-
-
-	<!-- LEMS port of isopotential.ode. Parameter names and order follow original file where possible. -->
+	<!-- LEMS port of xpp-models/isopotential.ode. Parameter names and order follow original file where possible. -->
 
 	<Include file="Simulation.xml"/>
 
 
-
 	<ComponentType name="IsopotentialCell">
 
 		<Parameter name="gleak" dimension="conductance" />
@@ -79,7 +75,6 @@
 			<DerivedVariable name="mtauKf" dimension="time" value="(1.94+2.66/(1+exp((V-8.12*in_mV)/(7.96*in_mV)))) * in_ms" />
 			<DerivedVariable name="hinfK" dimension="none" value="1/(1+exp((V+45*in_mV)/(6*in_mV)))" />
 			<DerivedVariable name="htauK" dimension="time" value="(1.79+515.8/(1+exp((V+147.4*in_mV)/(28.66*in_mV)))) * in_ms" />
-			<!-- TODO: What does that mean in isopotential.ode: mistake; should be hinfK == hinfK2 -->
 			<DerivedVariable name="hinfK2" dimension="none" value="1/(1+exp((V+44.2*in_mV)/(1.5*in_mV)))" />
 
 			<!-- na -->
@@ -171,8 +166,6 @@
             <!-- <Line id="Ikf" quantity="Ikf" scale="1pA"  color="#0000ff" timeScale="1ms" /> -->
             <!-- <Line id="Ina" quantity="Ina" scale="1pA"  color="#ffff00" timeScale="1ms" /> -->
             <!-- <Line id="Inap" quantity="Inap" scale="1pA"  color="#ff00ff" timeScale="1ms" /> -->
-
-            <!-- <Line id="hKf2" quantity="hKf2" scale="1"  color="#ff0000" timeScale="1ms" /> -->
         </Display>
 
         <OutputFile fileName="isopotential_LEMS.dat">
@@ -184,6 +177,4 @@
     <Target component="sim1" />
 
 
-
-
 </Lems>
\ No newline at end of file
diff --git a/NeuroML2/isopotential_NeuroML2/isopotential.cell.nml b/NeuroML2/isopotential_NeuroML2/isopotential.cell.nml
index 5152cf6..5eb6129 100644
--- a/NeuroML2/isopotential_NeuroML2/isopotential.cell.nml
+++ b/NeuroML2/isopotential_NeuroML2/isopotential.cell.nml
@@ -3,8 +3,7 @@
     xsi:schemaLocation="http://www.neuroml.org/schema/neuroml2  https://raw.github.com/NeuroML/NeuroML2/master/Schemas/NeuroML2/NeuroML_v2beta2.xsd"
     id="isopotential">
 
-    <!-- Work in progress - this is NOT intended for public use yet -->
-    <!-- Pure NeuroML2 version of isopotential.ode. Uses  NeuroML2 ComponentTypes exclusively. Parameter names and order follow original file where possible. -->
+    <!-- NeuroML2 port of xpp-models/isopotential.ode. Uses NeuroML2 ComponentTypes (plus some custom ComponentTypes in LEMS). Parameter names and order follow original file where possible. -->
 
     <Include file="leak.channel.nml" />
     <Include file="Ks.channel.nml" />
diff --git a/NeuroML2/isopotential_NeuroML2/network.net.nml b/NeuroML2/isopotential_NeuroML2/network.net.nml
index 77260d3..f658fa4 100644
--- a/NeuroML2/isopotential_NeuroML2/network.net.nml
+++ b/NeuroML2/isopotential_NeuroML2/network.net.nml
@@ -3,6 +3,8 @@
     xsi:schemaLocation="http://www.neuroml.org/schema/neuroml2  https://raw.github.com/NeuroML/NeuroML2/master/Schemas/NeuroML2/NeuroML_v2beta2.xsd"
     id="network">
 
+    <!-- Simple network with a single cell and a current pulse. -->
+
 	<Include file="isopotential.cell.nml" />
 
 	<pulseGenerator id="pulseGenStart" delay="0ms" duration="10ms" amplitude="-12pA" />
diff --git a/NeuroML2/isopotential_NeuroML2/run.xml b/NeuroML2/isopotential_NeuroML2/run.xml
index 5806d23..1b65c19 100644
--- a/NeuroML2/isopotential_NeuroML2/run.xml
+++ b/NeuroML2/isopotential_NeuroML2/run.xml
@@ -2,8 +2,7 @@
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.neuroml.org/lems/0.7.3 LEMS_v0.7.3.xsd">
 
-
-    <!-- Work in progress - this is NOT intended for public use yet -->
+    <!-- Short LEMS/NeuroML2 Script to run the simulation -->
 
     <!-- Include standard NeuroML2 ComponentType definitions -->
     <Include file="Simulation.xml" />
@@ -26,5 +25,4 @@
 
     </Simulation>
 
-
 </Lems>
\ No newline at end of file
diff --git a/NeuroML2/isopotential_NeuroML2/sigmoidOffsetTimeCourse.xml b/NeuroML2/isopotential_NeuroML2/sigmoidOffsetTimeCourse.xml
index 425a55d..16b2979 100644
--- a/NeuroML2/isopotential_NeuroML2/sigmoidOffsetTimeCourse.xml
+++ b/NeuroML2/isopotential_NeuroML2/sigmoidOffsetTimeCourse.xml
@@ -2,6 +2,7 @@
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.neuroml.org/lems/0.7.3 LEMS_v0.7.3.xsd">
 
+    <!-- Voltage-dependent time constant that has a sigmoid shape and an offset -->
 	<ComponentType name="sigmoidOffsetTimeCourse" extends="baseVoltageDepTime">
 
         <Parameter name="offset" dimension="time" />