Use generated list of contributors

And move it to a separate file as it occupies quite a lot of space in
the README and wasn't being kept up to date.

Generated using:

  curl -i -H "Accept: application/json" -H "Content-Type: application/json"  -X GET https://api.github.com/repos/michaeljones/breathe/contributors

And jq & vim.

CONTRIBUTORS.rst

@@ -0,0 +1,37 @@
+Contributors
+============
+
+Many thanks to everyone that has contributed to the project.
+
+- `Andne <https://github.com/Andne>`_
+- `arximboldi <https://github.com/arximboldi>`_
+- `D4N <https://github.com/D4N>`_
+- `dean0x7d <https://github.com/dean0x7d>`_
+- `dg-dboehi <https://github.com/dg>`_
+- `eric-wieser <https://github.com/eric>`_
+- `fetzerch <https://github.com/fetzerch>`_
+- `gmarull <https://github.com/gmarull>`_
+- `hidmic <https://github.com/hidmic>`_
+- `ishitatsuyuki <https://github.com/ishitatsuyuki>`_
+- `jakobandersen <https://github.com/jakobandersen>`_
+- `mattip <https://github.com/mattip>`_
+- `michaeljones <https://github.com/michaeljones>`_
+- `nijel <https://github.com/nijel>`_
+- `olitheolix <https://github.com/olitheolix>`_
+- `pczerkas <https://github.com/pczerkas>`_
+- `queezythegreat <https://github.com/queezythegreat>`_
+- `remyleone <https://github.com/remyleone>`_
+- `rhssk <https://github.com/rhssk>`_
+- `rogerbarton <https://github.com/rogerbarton>`_
+- `ropg <https://github.com/ropg>`_
+- `rscohn2 <https://github.com/rscohn2>`_
+- `rweickelt <https://github.com/rweickelt>`_
+- `SylvainCorlay <https://github.com/SylvainCorlay>`_
+- `t-b <https://github.com/t>`_
+- `Tiwalun <https://github.com/Tiwalun>`_
+- `utzig <https://github.com/utzig>`_
+- `vermeeren <https://github.com/vermeeren>`_
+- `vitaut <https://github.com/vitaut>`_
+- `xuhongxu96 <https://github.com/xuhongxu96>`_
+
+And many more via issues and suggestions.

README.rst

@@ -154,44 +154,17 @@ See the ``mkrelease`` utility in the root of the repository.
 Useful vim command for changelog conversion to the git tag format:
 ``%s/\v`(#[0-9]+) \<[^`]*`__/\1/g``.
 
-Credits
--------
+Maintainers
+-----------
 
-Breathe is currently maintained by `vermeeren <https://github.com/vermeeren>`_
+Breathe is currently maintained by `vermeeren <https://github.com/vermeeren>`_ & `jakobandersen <https://github.com/jakobandersen>`_
 and was formerly maintained by `michaeljones <https://github.com/michaeljones>`_
-& `vitaut <https://github.com/vitaut>`_, contributors include:
-
-- `nijel <https://github.com/nijel>`_
-- `sebastianschaetz <https://github.com/sebastianschaetz>`_
-- `mbolivar <https://github.com/mbolivar>`_
-- `queezythegreat <https://github.com/queezythegreat>`_
-- `abingham <https://github.com/abingham>`_
-- `davidm <https://github.com/davidm>`_
-- `hobu <https://github.com/hobu>`_
-- `magro11 <https://github.com/magro11>`_
-- `scopatz <https://github.com/scopatz>`_
-- `vonj <https://github.com/vonj>`_
-- `jmnas <https://github.com/jmnas>`_
-- `donkopotamus <https://github.com/donkopotamus>`_
-- `jo3w4rd <https://github.com/jo3w4rd>`_
-- `Anthony Truchet <https://github.com/AnthonyTruchet>`_
-- `Daniel Matz <https://github.com/danielmatz>`_
-- `Andrew Hundt <https://github.com/ahundt>`_
-- `sebastinas <https://github.com/sebastinas>`_
-- `robo9k <https://github.com/robo9k>`_
-- `sieben <https://github.com/sieben>`_
-- `rweickelt <https://github.com/rweickelt>`_
-- `sam-roth <https://github.com/sam-roth>`_
-- `bnewbold <https://github.com/bnewbold>`_
-- `serge-sans-paille <https://github.com/serge-sans-paille>`_
-- `dean0x7d <https://github.com/dean0x7d>`_
-- `Andne <https://github.com/Andne>`_
-- `Tiwalun <https://github.com/Tiwalun>`_
-- `eric-wieser <https://github.com/eric-wieser>`_
-- `olitheolix <https://github.com/olitheolix>`_
-- Many more, this list is rather outdated. Refer to the git history.
-
-Thanks to:
+& `vitaut <https://github.com/vitaut>`_.
+
+See `CONTRIBUTORS <https://github.com/michaeljones/breathe/blob/master/CONTRIBUTORS.rst`_ for the full list.
+
+Acknowledgements
+----------------
 
 - Dimitri van Heesch for `Doxygen <http://www.stack.nl/~dimitri/doxygen/>`_.
 - Georg Brandl for `Sphinx <http://sphinx-doc.org>`_.