diff --git a/README.rst b/README.rst
index 9232421930e405942c925ec89acabf776879bfd3..8b5349e3678de2673848ac166f24f55da36d10f2 100644
--- a/README.rst
+++ b/README.rst
@@ -15,30 +15,31 @@
 
 kmos3: Kinetic Modeling of Stripes, Surfaces, and Solids
 ========================================================
-*kmos3 is designed for lattice based Kinetic Monte Carlo simulations to understand chemical kinetics and mechanisms. It has been used to produce more than 10 scientific publications. Links to tutorials and other documentation are below.*
+kmos3 is designed for lattice based kinetic Monte Carlo simulations to understand chemical
+kinetics and mechanisms. It has been used to produce a multitude of scientific publications.
 
 
-DOCUMENTATION
-##############
+Documentation
+#############
 
-Please refer to
+Please refer to the
 
-* `Documentation <http://kmcos.readthedocs.org>`_
-* `Examples <examples>`_
-* `Workshop files <https://github.com/kmcos/intro2kmcos>`_ [the later part of the document are for advanced users and may require an instructor]
+* `documentation <https://kmos3.org/doc/>`_
+* `examples <examples>`_
+* `workshop files <https://gitlab.mpcdf.mpg.de/fhi-theory/intro2kmos3>`_
 
 
-HELP, BUGS, ISSUES, TROUBLE
+Help, Bugs, Issues, Trouble
 ###########################
 
-This code is research code for scientists by scientists. If you
-believe you have hit a bug or have a feature request get in touch
-with us either via `mail <kmos3@fhi.mpg.de>`_,
-or open an `issue <https://gitlab.mpcdf.mpg.de/fhi-theory/kmos3/-/issues/new>`_ .
+This code is research code for scientists by scientists. If you believe you have hit a bug or have
+a feature request get in touch with us either via an email to kmos3.at.fhi.mpg, or open an
+`issue <../-/issues/new>`_.
 
 
-CONTRIBUTORS
+Contributors
 ############
+
 Current Project Leaders:
 
 * Karsten Reuter
@@ -56,6 +57,7 @@ Developers:
 * Michal Bajdich
 * Andreas Garhammer
 * Aditya (Ashi) Savara
+* Simon Hollweger
 
 Other:
 
@@ -66,12 +68,12 @@ Other:
 * Meelod Waheed
 * Pia Hein
 
-THANKS
+
+Thanks
 ######
 
-This project draws on other great Python modules, which are in turn
-each free software and we would like to thank each of these projects for
-making their code freely avalaible, namely:
+This project draws on other great Python modules, which are in turn each free software and we
+would like to thank each of these projects for making their code freely avalaible, namely:
 
 * `Python <https://www.python.org/>`_
 * `ASE <https://wiki.fysik.dtu.dk/ase/>`_
@@ -142,19 +144,18 @@ making their code freely avalaible, namely:
 .. | │   └── kmos3-install-dependencies-ubuntu
 
 
-COPYRIGHT AND LICENSE
+Copyright and License
 #####################
 
 Copyright (C) 2009-13 Max J. Hoffmann
 
-This program is free software; you can redistribute it and/or modify it under
-the terms of the GNU General Public License as published by the Free Software
-Foundation; either version 3 of the License, or (at your option) any later
-version.
+This program is free software; you can redistribute it and/or modify it under the terms of the GNU
+General Public License as published by the Free Software Foundation; either version 3 of the
+License, or (at your option) any later version.
 
-This program is distributed in the hope that it will be useful, but WITHOUT
-ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
-FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
+even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+General Public License for more details.
 
-You should have received a copy of the GNU General Public License along with
-this program; if not, see `https://www.gnu.org/licenses/ <https://www.gnu.org/licenses/>`_.
+You should have received a copy of the GNU General Public License along with this program. If not,
+see `https://www.gnu.org/licenses/ <https://www.gnu.org/licenses/>`_.