Move EvolvablePlayer Moran docs to further_topics

Author: marcharper

docs/tutorials/further_topics/evolvable_players.rst

@@ -13,3 +13,20 @@ New :code:`EvolvablePlayer` subclasses can be added to the library. Any strategy
 define :code:`mutation` and :code:`crossover` methods can be used with the evolutionary algorithm
 and the atomic mutation version of the Moran process. To use the particle swarm algorithms, methods
 to serialize the strategy to and from a vector of floats must be defined.
+
+Moran Process: Atomic Mutation for Evolvable Players
+----------------------------------------------------
+
+Additionally, the Moran process implementation supports a second style of mutation suitable for
+evolving new strategies utilizing the :code:`EvolvablePlayer` class via its :code:`mutate` method.
+This is in contrast to the transitional mutation that selects one of the other player types rather than (possibly)
+generating a new player variant. To use this mutation style set `mutation_method=atomic` in the initialisation
+of the Moran process:
+
+    >>> C = axl.Action.C
+    >>> players = [axl.EvolvableFSMPlayer(num_states=2, initial_state=1, initial_action=C) for _ in range(5)]
+    >>> mp = axl.MoranProcess(players, turns=10, mutation_method="atomic")
+    >>> population = mp.play()  # doctest: +SKIP
+
+Note that this may cause the Moran process to fail to converge, if the mutation rates are very high or the
+population size very large.  See :ref:`moran` for more information.

docs/tutorials/getting_started/moran.rst

@@ -99,6 +99,9 @@ use a larger population to get a bit more data::
    :width: 50%
    :align: center
 
+Moran Process with Mutation
+---------------------------
+
 The :code:`MoranProcess` class also accepts an argument for a mutation rate.
 Nonzero mutation changes the Markov process so that it no longer has absorbing
 states, and will iterate forever. To prevent this, iterate with a loop (or
@@ -132,18 +135,3 @@ Other types of implemented Moran processes:
 
 - :ref:`moran-process-on-graphs`
 - :ref:`approximate-moran-process`
-
-Atomic Mutation for Evolvable Players
--------------------------------------
-
-Additionally, the Moran process implementation supports a second style of mutation suitable for
-evolving new strategies. The :code:`EvolvablePlayer` class supplies a method that typically produces
-a similar but mutated strategy. This is in contrast to the above method of mutation that selects
-one of the other player types rather than generating a new player type. To use this mutation style
-set `mutation_method=atomic`
-
-    >>> C = axl.Action.C
-    >>> players = [axl.EvolvableFSMPlayer(num_states=2, initial_state=1, initial_action=C) for _ in range(5)]
-    >>> mp = axl.MoranProcess(players, turns=10, mutation_method="atomic")
-    >>> population = mp.play()  # doctest: +SKIP
-