doc: create Explanation section, move "About this file" to it

jabber.org

@@ -3,7 +3,7 @@
 #+PROPERTY: header-args :tangle yes :load yes :comments link
 #+TODO: TODO WIP EXTEND CLEANUP FIXME REVIEW |
 
-* README
+* Introduction
 This is jabber.el 0.8.92, an XMPP client for Emacs.  XMPP (also known as 'Jabber') is an instant messaging system; see http://xmpp.org for more information.
 
 New resources
@@ -92,62 +92,6 @@ This release of jabber.el contains support for file transfer.  You may need to c
 ** XMPP URIs
 It is possible to make various web browsers pass links starting with "xmpp:" to jabber.el.  In the ideal case, this works right after running "make install".  Otherwise, see the manual, section "XMPP URIs".
 
-* Credits
-** Developers
-+ Tom Berger
-+ Magnus Henoch
-+ Kirill A. Korinskiy
-+ Detlev Zundel
-  - wmii support
-+ Evgenii Terechkov
-
-** Contributors
-+ Georg Lehner
-  - network transport functions
-+ Anthony Chaumas-Pellet
-+ Jérémy Compostella
-+ Mathias Dahl
-  - history logging
-  - watch functionality
-+ Mario Domenech Goulart
-  - sawfish support
-  - xmessage support
-+ Nolan Eakins
-+ Ami Fischman
-  - Chat State Notifications
-+ François Fleuret
-+ David Hansen
-+ Adam Sjøgren
-  - notifications.el support
-+ Rodrigo Lazo
-  - notifications.el support
-  - libnotify.el support
-+ Justin Kirby
-+ Carl Henrik Lunde
-  - network transport functions
-  - activity tracking
-+ Olivier Ramonat
-+ Andrey Slusar
-+ Valery V. Vorotyntsev
-  - GMail notifications
-+ Milan Zamazal
-+ Xavier Maillard
-+ Vitaly Mayatskikh
-+ Alexander Solovyov
-+ Demyan Rogozhin
-  - XML console mode
-+ Michael Cardell Widerkrantz
-  - tmux support
-
-** Maintainers
-+ wgreenhouse
-  - 2021 resurrection
-+ contrapunctus
-  - literate Org migration
-  - Makefile
-+ tomasino on #team@irc.tilde.chat
-  - helping contrapunctus debug the Makefile
-
 * TODO maintenance [0%]
 1. [ ] Satisfy =M-x checkdoc=
 2. [ ] Use =rx= where regular expressions get hairy
@@ -157,14 +101,15 @@ It is possible to make various web browsers pass links starting with "xmpp:" to
 3. [ ] hexrgb.el is not available on MELPA
 4. [ ] Migrate tests to ERT/Buttercup/etc
 
-* About this file
+* Explanation
+** About this file
 jabber.el is an Org literate program. Tangling is done automatically after each save.
 
 Alternatively, it is possible to use =literate-elisp-load= from  [[https://github.com/jingtaozf/literate-elisp][literate-elisp]] to directly load this Org file. This way, links to the source (e.g. =describe-*= buffers, byte-compilation messages) take the user directly to the Org file rather than to the tangled source.
 
 If a source block does not have syntax highlighting, press =M-o M-o= (=font-lock-fontify-block=) in it.
 
-** TODO literate/organizational tasks [25%]
+*** TODO literate/organizational tasks [25%]
 1. [ ] (maybe) make dependencies optional and tangle them to separate files, reducing load time for users.
 2. [ ] contemplate [[https://github.com/melpa/melpa/issues/7408][distribution strategies]]
 3. [ ] make headings for remaining definitions - some FSM-related definitions remain.
@@ -16642,3 +16587,58 @@ Contents of process buffers might be useful for debugging."
 ;;; jabber.el ends here
 
 #+END_SRC
+* Credits
+** Developers
++ Tom Berger
++ Magnus Henoch
++ Kirill A. Korinskiy
++ Detlev Zundel
+  - wmii support
++ Evgenii Terechkov
+
+** Contributors
++ Georg Lehner
+  - network transport functions
++ Anthony Chaumas-Pellet
++ Jérémy Compostella
++ Mathias Dahl
+  - history logging
+  - watch functionality
++ Mario Domenech Goulart
+  - sawfish support
+  - xmessage support
++ Nolan Eakins
++ Ami Fischman
+  - Chat State Notifications
++ François Fleuret
++ David Hansen
++ Adam Sjøgren
+  - notifications.el support
++ Rodrigo Lazo
+  - notifications.el support
+  - libnotify.el support
++ Justin Kirby
++ Carl Henrik Lunde
+  - network transport functions
+  - activity tracking
++ Olivier Ramonat
++ Andrey Slusar
++ Valery V. Vorotyntsev
+  - GMail notifications
++ Milan Zamazal
++ Xavier Maillard
++ Vitaly Mayatskikh
++ Alexander Solovyov
++ Demyan Rogozhin
+  - XML console mode
++ Michael Cardell Widerkrantz
+  - tmux support
+
+** Maintainers
++ wgreenhouse
+  - 2021 resurrection
++ contrapunctus
+  - literate Org migration
+  - Makefile
++ tomasino on #team@irc.tilde.chat
+  - helping contrapunctus debug the Makefile