libtiff: doc: Tidy top-level index

From ffeff66cf2c24c35447c7fff14a75d7ab97d6172 Mon Sep 17 00:00:00 2001
From: Roger Leigh <[EMAIL REDACTED]>
Date: Sun, 5 Jun 2022 11:08:52 +0100
Subject: [PATCH] doc: Tidy top-level index

---
 doc/index.rst                    | 40 ++++++++------------------------
 doc/project/acknowledgements.rst | 21 +++++++++++++++++
 doc/project/bugs.rst             |  9 ++++---
 doc/project/index.rst            | 14 ++++++++++-
 4 files changed, 48 insertions(+), 36 deletions(-)

diff --git a/doc/index.rst b/doc/index.rst
index 210f6cba..a9496e13 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -19,41 +19,21 @@ LibTIFF - TIFF Library and Utilities
     Source repository      https://gitlab.com/libtiff/libtiff
     =====================  =====================================
 
-This software provides support for the *Tag Image File Format* (TIFF),
+The LibTIFF software provides support for the *Tag Image File Format* (TIFF),
 a widely used format for storing image data.  The latest version of
-the TIFF specification is :doc:`specification/index`
-available on-line in several different formats.
+the TIFF specification is :doc:`specification/index`.
 
-Included in this software distribution is a library, libtiff, for
-reading and writing TIFF, a small collection of tools for doing
-simple manipulations of TIFF images, and documentation on the
-library and tools.  Libtiff is a portable software, it was built
-and tested on various systems: UNIX flavors (Linux, BSD, Solaris,
-MacOS X), Windows, and OpenVMS.  It should be possible to port
-libtiff and additional tools on other OSes.
+Included in this software distribution are:
 
-The library, along with associated tool programs, should handle most of
-your needs for reading and writing TIFF images on 32- and 64-bit
-machines.
+* a library, libtiff, for reading and writing TIFF images
+* a small collection of tools for performing simple manipulations of TIFF images
+* documentation for the library and tools.
 
-The software was originally authored and maintained by Sam Leffler
-but has been maintained by a cast of others since 1999.
+The libtiff library, along with associated tool programs, should handle most of
+your needs for reading and writing TIFF images.
 
-Questions should be sent to the TIFF mailing list:
-`tiff@lists.osgeo.org`_, with
-a subscription interface at
-http://lists.osgeo.org/mailman/listinfo/tiff.
-The persons currently actively maintaining and releasing libtiff
-are Even Rouault and
-`Bob Friesenhahn <bfriesen@GraphicsMagick.org>`_.
-Note from Even Rouault: do not email me personally, especially when asking
-"when is the next release ?", unless you are willing to
-pay a LOT of money for my services, and I may even not be interested.
-
-Significant maintainers in the past (since the 3.5.1 release) are
-`Frank Warmerdam <http://pobox.com/~warmerdam>`_,
-`Andrey Kiselev <dron@ak4719.spb.edu>`_,
-Joris Van Damme, and Lee Howard.
+LibTIFF is portable software, supported on various operating systems including
+UNIX (Linux, BSD, MacOS X) and Windows.
 
 The following sections are included in this documentation:
 
diff --git a/doc/project/acknowledgements.rst b/doc/project/acknowledgements.rst
index 7a33a416..a3d9da96 100644
--- a/doc/project/acknowledgements.rst
+++ b/doc/project/acknowledgements.rst
@@ -5,6 +5,9 @@ Acknowledgments
     :width: 124
     :alt: ring
 
+Maintainers
+-----------
+
 The LibTIFF software was written by Sam Leffler while working for
 Silicon Graphics.
 
@@ -14,6 +17,24 @@ operations, correctness, or whatever.  If you do anything useful with
 all or parts of it you need to honor the copyright notices.  It would
 also be nice to be acknowledged.
 
+LibTIFF as been maintained by cast of others since 1999.
+
+The persons currently actively maintaining and releasing libtiff are:
+
+* Even Rouault
+* `Bob Friesenhahn <bfriesen@GraphicsMagick.org>`_
+
+Significant maintainers in the past (since the 3.5.1 release) were:
+
+* `Frank Warmerdam <http://pobox.com/~warmerdam>`_
+* `Andrey Kiselev <dron@ak4719.spb.edu>`_
+* Joris Van Damme
+* Lee Howard
+
+
+Contributors
+------------
+
 The LZW algorithm is derived from the compress program (the proper attribution
 is included in the source code).
 
diff --git a/doc/project/bugs.rst b/doc/project/bugs.rst
index 16db85ef..af0d1bac 100644
--- a/doc/project/bugs.rst
+++ b/doc/project/bugs.rst
@@ -9,18 +9,17 @@ Reporting Bugs
 Overview
 --------
 
-This software is free and maintained by a community of professionals and volunteers.
-Please let us know when you find a problem or fix a bug.
-
-The project uses `GitLab issues <https://gitlab.com/libtiff/libtiff/issues/>`_
+The LibTIFF project uses `GitLab issues <https://gitlab.com/libtiff/libtiff/issues/>`_
 to report and manage bugs and feature requests.
 
+Please let us know when you find a problem or fix a bug.
+
 Previously, the project used
 `MapTools.org bugzilla <http://bugzilla.maptools.org/buglist.cgi?query_format=advanced&short_desc_type=regexp&short_desc=.&product=libtiff&long_desc_type=allwordssubstr&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=RESOLVED&bug_status=VERIFIED&bug_status=CLOSED&emailtype1=substring&email1=&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Bug+Number&field0-0-0=noop&type0-0-0=noop&value0-0-0=>`_
 to track bugs. All remaining tickets in that bugzilla instance were
 migrated to GitLab issues, and this system should no longer be used.
 All bugs filed in a older bugzilla at
-`RemoteSensing.org <http://bugzilla.remotesensing.org/>`_ (pre April 2008)
+`RemoteSensing.org <http://bugzilla.remotesensing.org/>`_ (pre-April 2008)
 have unfortunately been lost.
 
 
diff --git a/doc/project/index.rst b/doc/project/index.rst
index d36beb79..f036c8ef 100644
--- a/doc/project/index.rst
+++ b/doc/project/index.rst
@@ -2,7 +2,19 @@
 LibTIFF Project
 ###############
 
-The following sections are included:
+The LibTIFF project provides free software maintained by a small community of software developers.  See
+:doc:`acknowledgements` for further details.
+
+Questions should be sent to the :doc:`mailinglist`.
+
+.. note::
+
+    Please do not email the maintainers personally, especially when asking
+    questions such as "when is the next release?".  Please use the public mailing lists.
+    While the maintainers and contributors to LibTIFF are primarily professional software
+    developers, none of us are paid to work on LibTIFF directly, and almost all the
+    activity is voluntary and unpaid.
+
 
 .. toctree::
     :maxdepth: 1