Response to most review comments

doc/_static/custom_math/annual_energy_balance.yaml

@@ -5,8 +5,8 @@
 # annual_source_max
 
 # New top-level parameters:
-# annual_flow_max (if grouping technologies and/or nodes)
-# flow_max_group (if grouping technologies and/or nodes)
+# annual_flow_max (if summing over technologies and/or nodes)
+# flow_max_group (if summing over technologies and/or nodes)
 
 constraints:
   annual_energy_balance_per_tech_and_node:

doc/_static/custom_math/demand_share_per_timestep_decision.yaml

@@ -8,8 +8,9 @@
 # Specifying `relaxation` inside the constraint to a non-zero value allows the constraint some flexibility around a given value, making a model easier to solve.
 
 # New top-level parameters:
-# relaxation (defined here directly)
-# total share limit (defined here directly)
+# relaxation (defined here directly).
+# demand_share_limit.
+# decide_demand_share <- Link supply technologies to the demand technology they are going to be a share of.
 
 variables:
   demand_share_per_timestep_decision:

doc/_static/custom_math/fuel_dist.yaml

@@ -8,6 +8,7 @@
 # fuel_export_max
 # fuel_distribution_max
 # fuel_distributor_costs
+# allow_fuel_distribution <- lookup array with a value of `True` for each carrier where you want to track its distribution
 
 variables:
   fuel_distributor:

src/calliope/math/base.yaml

@@ -546,7 +546,7 @@ variables:
       max: storage_cap_max
 
   storage:
-    description: "The carrier stored by a `supply_plus` or `storage` technology in each timestep."
+    description: "The carrier stored by a `storage` technology in each timestep."
     unit: energy
     foreach: [nodes, techs, timesteps]
     where: "include_storage=True"