From 582455a501b20b1a8a36269d9c9070d476df7721 Mon Sep 17 00:00:00 2001
From: Roger Leigh <[EMAIL REDACTED]>
Date: Sun, 5 Jun 2022 10:39:22 +0100
Subject: [PATCH] doc: Move bugs to project
---
doc/bugs.rst | 48 -----------------------------------
doc/index.rst | 1 -
doc/project/bugs.rst | 50 +++++++++++++++++++++++++++++++++++++
doc/project/index.rst | 2 ++
doc/project/mailinglist.rst | 27 ++++++++++++++++++++
5 files changed, 79 insertions(+), 49 deletions(-)
delete mode 100644 doc/bugs.rst
create mode 100644 doc/project/bugs.rst
create mode 100644 doc/project/mailinglist.rst
diff --git a/doc/bugs.rst b/doc/bugs.rst
deleted file mode 100644
index 4dbe281e..00000000
--- a/doc/bugs.rst
+++ /dev/null
@@ -1,48 +0,0 @@
-Bugs and the TIFF Mailing List
-==============================
-
-.. image:: images/cover.jpg
- :width: 110
- :alt: cover
-
-This software is free. Please let us know when you find a problem or
-fix a bug.
-
-The project is using `GitLab issues <https://gitlab.com/libtiff/libtiff/issues/>`_
-since October 2019.
-Previously, the project used MapTools.org
-bugzilla to track bugs: remaining tickets in that bugzilla instance have been
-migrated to GitLab issues. All bugs filed in a older bugzilla at
-bugzilla.remotesensing.org (pre April 2008) have unfortunately been lost.
-
-If you think you've discovered a bug, please first check to see if it is
-already known by looking at the list of already reported bugs. Also verify that
-the problem is still reproducible with the current development software
-from GitLab.
-
-If you'd like to enter a new bug, you can do so at
-`<https://gitlab.com/libtiff/libtiff/issues/new/>`_
-
-If you'd like to inform us about some kind of security issue that should not
-be disclosed for a period of time, then you can contact maintainers directly.
-Send a copies of your report to the following people: Frank Warmerdam
-`<warmerdam@pobox.com>`_
-and
-Bob Friesenhahn `<bfriesen@simple.dallas.tx.us>`_.
-
-Of course, reporting bugs is no substitute for discussion. The
-`<tiff@lists.osgeo.org>`_ mailing list is for users of this software, and
-discussion TIFF issues in general.
-It is managed with the Mailman software, and the web interface for subscribing
-and managing your access to the list is at:
-
- `<http://lists.osgeo.org/mailman/listinfo/tiff/>`_
-
-Posts to the list are only accepted from members of the list in order
-to limit the amount of spam propagated.
-
-A `Long Term Archive <http://www.awaresystems.be/imaging/tiff/tml.html>`_
-including recent messages, and most messages back to 1993,
-with search capabilities is available, and
-has been prepared and hosted by
-`AWare Systems <http://www.awaresystems.be>`_.
diff --git a/doc/index.rst b/doc/index.rst
index d1d0acb4..210f6cba 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -69,7 +69,6 @@ The following sections are included in this documentation:
contrib
specification/index
build
- bugs
images
project/index
manpages
diff --git a/doc/project/bugs.rst b/doc/project/bugs.rst
new file mode 100644
index 00000000..16db85ef
--- /dev/null
+++ b/doc/project/bugs.rst
@@ -0,0 +1,50 @@
+Reporting Bugs
+==============
+
+.. image:: ../images/cover.jpg
+ :width: 110
+ :alt: cover
+
+
+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/>`_
+to report and manage bugs and feature requests.
+
+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)
+have unfortunately been lost.
+
+
+Reporting a bug
+---------------
+
+If you think you've discovered a bug, please first check to see if it is
+already known by looking at the list of already reported bugs. Also, please
+verify that the problem is still reproducible with the current development
+software from GitLab.
+
+If you'd like to enter a new bug report, you can create a
+`new GitLab issue <https://gitlab.com/libtiff/libtiff/issues/new/>`_
+
+Of course, reporting bugs is no substitute for discussion.
+Please see the :doc:`mailinglist` page for further details.
+
+
+Reporting a security issue
+--------------------------
+
+If you'd like to inform us about some kind of security issue that should not
+be disclosed for a period of time, then you can contact the maintainers directly.
+Send a copies of your report to the following people:
+
+* Frank Warmerdam `<warmerdam@pobox.com>`_
+* Bob Friesenhahn `<bfriesen@simple.dallas.tx.us>`_.
diff --git a/doc/project/index.rst b/doc/project/index.rst
index e61cd71d..d36beb79 100644
--- a/doc/project/index.rst
+++ b/doc/project/index.rst
@@ -9,4 +9,6 @@ The following sections are included:
:titlesonly:
license
+ mailinglist
+ bugs
acknowledgements
diff --git a/doc/project/mailinglist.rst b/doc/project/mailinglist.rst
new file mode 100644
index 00000000..0dd9134b
--- /dev/null
+++ b/doc/project/mailinglist.rst
@@ -0,0 +1,27 @@
+Mailing List
+============
+
+
+Overview
+--------
+
+The `tiff@lists.osgeo.org <tiff@lists.osgeo.org>`_ mailing list is for users of the LibTIFF software, and
+discussion TIFF issues in general.
+
+
+Subscription
+------------
+
+The mailing list managed with the Mailman software, and the web interface for subscribing
+and managing your access to the list is at: `<http://lists.osgeo.org/mailman/listinfo/tiff/>`_
+
+Posts to the list are only accepted from members of the list.
+
+
+Archive
+-------
+
+A `Long Term Archive <http://www.awaresystems.be/imaging/tiff/tml.html>`_
+including recent messages, and most messages back to 1993,
+with search capabilities is available. This archive has been prepared
+and hosted by `AWare Systems <http://www.awaresystems.be>`_.