doc: implement review feedback (amend)

doc/index.rst

@@ -34,7 +34,9 @@ PyPSA-Eur: A Sector-Coupled Open Optimisation Model of the European Energy Syste
 |
 
 PyPSA-Eur is an open model dataset of the European energy system at the
-transmission network level that covers the full ENTSO-E area.
+transmission network level that covers the full ENTSO-E area. It covers demand
+and supply for all energy sectors. From version v0.8.0, PyPSA-Eur includes all
+the features from PyPSA-Eur-Sec, which is now deprecated.
 
 Electricity System
 ==================
@@ -59,13 +61,14 @@ effects for renewable power generation and their varying resource availability.
 Sector-Coupled Energy System
 ============================
 
-A sector-coupled extension (previously known as **PyPSA-Eur-Sec**) adds demand
-and supply for the following sectors: transport, space and water heating,
-biomass, energy consumption in the agriculture, industry and industrial
-feedstocks, carbon management, carbon capture and usage/sequestration. This
-completes the energy system and includes all greenhouse gas emitters except
-waste management, agriculture, forestry and land use. The diagram below gives an
-overview of the sectors and the links between them:
+A sector-coupled extension (previously known as **PyPSA-Eur-Sec**, which is now
+deprecated) adds demand and supply for the following sectors: transport, space
+and water heating, biomass, energy consumption in the agriculture, industry and
+industrial feedstocks, carbon management, carbon capture and
+usage/sequestration. This completes the energy system and includes all
+greenhouse gas emitters except waste management, agriculture, forestry and land
+use. The diagram below gives an overview of the sectors and the links between
+them:
 
 .. image:: ../graphics/multisector_figure.png
     :width: 70%
@@ -93,7 +96,9 @@ About
 
 PyPSA-Eur is designed to be imported into the open energy system modelling
 framework `PyPSA <https://www.pypsa.org>`_ for which `documentation
-<https://pypsa.readthedocs.io>`_ is available as well.
+<https://pypsa.readthedocs.io>`_ is available as well. However, since the
+workflow is modular, it should be easy to adapt the data workflow to other
+modelling frameworks.
 
 The restriction to freely available and open data encourages the open exchange
 of model data developments and eases the comparison of model results. It

scripts/plot_network.py

@@ -6,7 +6,7 @@
 """
 Creates plots for optimised network topologies, including electricity, gas and
 hydrogen networks, and regional generation, storage and conversion capacities
-built.
+built. This rule plots a map of the network with technology capacities at the nodes.
 """
 
 import logging