MAINT Update and rearrange 'lateral_interaction.rst'

doc/source/topic_guides/combinatorics.rst

+Conquering Combinatorics with *itertools*
+-----------------------------------------
+
+Even restricting oneself to nearest neighbor lateral interactions or a number of different
+configurations to be considered for lateral interactions can quickly lead to a couple of tens or
+hundreds. A phenomenon which is among practitioners humbly referred to as *combinatorial
+explosion*. Unfortunately, manually typing all these combinations is usually tiring and very error
+prone. Fortunately, the ``itertools`` module from the python standard library allows to very
+quickly generate all needed configurations. Before delving into the practical steps of this I
+would like to point out that lateral interactions typically slow down the simulation by about
+one order of magnitude, which is a purely empirical fact.

doc/source/topic_guides/index.rst

@@ -4,10 +4,11 @@
 Topic Guides
 ============
 
-The conceptual parts of this topic guide predate the `kmos3 paper <http://dx.doi.org/10.1016/j.cpc.2014.04.003>`_
-(`arXiv <http://arxiv.org/abs/1401.5278>`_). Please refer to the paper for a thorough background on kMC
-and lattice kMC on crystal surfaces. The more technical parts stated below might still be useful for using
-kmos3.
+The conceptual parts of this topic guide predate the
+`kmos3 paper <https://doi.org/10.1016/j.cpc.2014.04.003>`_
+(`arXiv <https://arxiv.org/abs/1401.5278>`_). Please refer to the paper for a thorough background
+on KMC and lattice KMC on crystal surfaces. The more technical parts stated below might still be
+useful for using kmos3.
 
 .. toctree::
   :maxdepth: 2
@@ -16,9 +17,8 @@ kmos3.
   workflows
   data_models
   kmos3_speed
-  temporal_acceleration
   lateral_interaction
-  otf_backend
+  temporal_acceleration
   proc_syntax
   coord_syntax
   developers_guide
@@ -27,6 +27,6 @@ kmos3.
 ..  The Editor Frontend
 ..  The Editor API
 ..  The Runtime Frontend
-..  On the kMC solver
-..  Nuts'n'Bolts of kMC
+..  On the KMC solver
+..  Nuts'n'Bolts of KMC
 ..  On the Random Number Generator

doc/source/topic_guides/lateral_interaction.rst

-Modeling lateral interaction
-============================
-
-Introduction
-^^^^^^^^^^^^
+Modeling Lateral Interactions
+=============================
 
+.. todo::
+  This page needs more work.
 
 Lateral Interaction Models
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------
+
 - pairwise interaction
 - bond-order potentials
 
-Conquering combinatorics with itertools
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-
-Even restricting oneself to nearest neighbor
-lateral interaction to number of different
-configurations to be considered for lateral
-interactions can quickly reach a couple
-of tens or hundred. A phenomenon which is
-among practitioners humbly referred to as
-*combinatorial explosions*. Unfortunately
-manually typing all these combinations if
-usually tiring and thus error prone.
-Fortunately the `itertools` module from the
-python standard library allows to very quickly
-generate all needed configurations. Before
-delving into the practical steps of this I
-would like to point out that lateral interaction
-typically slows down the simulation by about
-one order of magnitude, which is a purely
-empirical fact.
+.. include:: combinatorics.rst
+.. include:: otf_backend.rst