[GEOT-7756] Update communication information to address outdated http and irc information

jodygarnett · Copilot · jodygarnett · commit d8bdb41edebe · 2025-05-12T12:58:24.000-07:00
Apply suggestions from code review

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
diff --git a/docs/developer/communication.rst b/docs/developer/communication.rst
@@ -10,13 +10,12 @@ Email
 geotools-gt2-users
 ^^^^^^^^^^^^^^^^^^
 
-The users list is for questions regarding the installation or use of the GeoTools2 library. Users of GeoTools are usually java developers building applications with spatial capabilities.
+The users list is for questions regarding the installation or use of the GeoTools library. Users of GeoTools are usually Java developers building applications with spatial capabilities.
 
 * https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
-* http://sourceforge.net/mailarchive/forum.php?forum_name=geotools-gt2-users
-
-Sometimes, some small applications or server-side code will exist within the GeoTools code base (for example, a Web Map Service implementation or a conversion utility). If these have not yet found a project of their own, then questions about how to use them may be directed to this list.
+* https://sourceforge.net/mailarchive/forum.php?forum_name=geotools-gt2-users
 
+Although GeoTools is primarily a Java library, it is also used to host some small tools or server-side code (for example a refactoring script, or a format conversion utility). If these have not yet found a project of their own, then questions about how to use these tools may be directed to this list.
 
 geotools-devel
 ^^^^^^^^^^^^^^
@@ -25,8 +24,8 @@ Much of the development discussion happens on the geotools-devel mailing list.
 If your query is more general, e.g. you need help with how to use GeoTools,
 please use the geotools-gt2-users mailing list.
 
- * http://lists.sourceforge.net/lists/listinfo/geotools-devel
- * http://sourceforge.net/mailarchive/forum.php?forum_name=geotools-devel
+ * https://lists.sourceforge.net/lists/listinfo/geotools-devel
+ * https://sourceforge.net/mailarchive/forum.php?forum_name=geotools-devel
 
 The developer list is used by the development team of GeoTools solely to discuss development issues. The list is exclusively for:
 
@@ -42,8 +41,7 @@ Commit Tracker
 To follow new commits and pull requests to the GeoTools repository, GitHub provides a tracking feature called
 `Watching Repositories <https://help.github.com/articles/watching-repositories>`_. Following the instructions provided
 by GitHub you are able to customise the feed of information you are able to receive. Note that GeoTools doesn't utilise
-the issue feature of GitHub; see the `Issue tracker <http://docs.geotools.org/latest/developer/communication.html#issue-tracker>`_
-in the next section.
+the issue feature of GitHub; see the *Issue tracker* section below.
 
 Other pages that may be helpful in following GeoTools are the `pulse <https://github.com/geotools/geotools/pulse>`_ and
 the `commits <https://github.com/geotools/geotools/commits>`_. Both are pages that provide summary information about the
@@ -52,58 +50,55 @@ current activity of the project.
 Issue Tracker
 ---------------
 
-GeoTools tracks tasks, issues and bugs with its JIRA tracker, generously provided by OSGeo and hosted by Atlassian.
+GeoTools tracks tasks, issues and bugs with its JIRA tracker, provided by Atlassian cloud hosting for OSGeo Foundation.
 
 This is where all bugs should be reported, in addition to requested features and improvements.
 
 * https://osgeo-org.atlassian.net/projects/GEOT
 
 Filling out all fields is specially important for bug reports:
 
-* including component(s)
-* affected versions of geotools (a release or git commit hash)
+* Including component(s)
+* Affected versions of GeoTools
 * A description of what caused the problem (example code that reproduces the problem) along with any stack traces
-* The Java Version and the type of operating system you are using
-* You may wish to attach log files, or screen snapshots to the Jira task
-* If you are reporting failed tests during the maven build, check the test reports in
-  ``<module>/target/surefire-reports`` for further details
+* Java Version and the type of operating system you are using
+* Attach any supporting information such as log files, or screen snapshots
+* To reporting failed tests during the maven build, check the test reports in
+  ``<module>/target/surefire-reports`` for further details.
 
-The User Guide has an example of `creating a new issue <http://docs.geotools.org/latest/userguide/welcome/support.html#issue-tracker>`_.
+The User Guide has an example of `creating a new issue <https://docs.geotools.org/latest/userguide/welcome/support.html#issue-tracker>`_.
 
-Internet Relay Chat
---------------------
+Developer Chat
+--------------
 
-GeoTools developers use an IRC channel for real time collaboration (for situations where email is
-too slow) - this is also a suitable venue for questions.
+GeoTools has a developer chat on Gitter, which has migrated to Matrix Infrastructure.
 
-If you are new to IRC, you will need to find an IRC client. If you have configured your browser
-to support IRC (Firefox can use the Chatzilla plugin for example), and you can connect to a
-GeoTools meeting by clicking on the following URL:
-irc://irc.freenode.net/geotools.
+* `https://matrix.to/#/#geotools_geotools:gitter.im <https://matrix.to/#/#geotools_geotools:gitter.im>`__
 
-The information you need to configure your IRC client are:
+This is used on occasion when email is too slow - this is also a suitable venue for development questions.
 
-* Server - Pick one from Freenode Servers
-* Channel - #geotools
-* Port - 6667
+Video Chat
+----------
 
-IRC Breakout Meetings
+GeoTools Project Management Committee attends a 1 hour bi-weekly video chat. Meetings are at
+`17:30 UTC <https://www.timeanddate.com/worldclock/fixedtime.html?hour=18&min=30&sec=0&msg=GeoTools%20/%20GeoServer%20Meeting&ah=1&sort=1&p1=215>`__.
+If you wish to attend keep an eye on the developer list for an invite / reminder.
 
-* Occasionally breakout IRC meetings will be announced on the geotools-devel mailing list around
-  specific topics of interest.
+* https://meet.osgeo.org/GeoServerMeeting
 
-  Anyone is free to start a meeting; we ask that an email be sent out and a time negotiated on the
-  email list allowing interested parties to attend.
+Occasionally breakout meetings will be announced on the geotools-devel mailing list around
+specific topics of interest.
 
+Anyone is free to start a meeting; we ask that an email be sent out and a time coordinated on the email list allowing interested parties to attend.
 
 Wiki
 ----
 
-The development team has migrated to the use of GitHub wiki (in April of 2015) to work on design ideas and change proposals. Prior to this time Confluence was used.
+Use GitHub wiki to work on design ideas and change proposals:
 
 * https://github.com/geotools/geotools/wiki
 
-Developers can edit the wiki directly using the Edit button provided. 
+Developers can edit the wiki directly using the Edit button provided.
 
 If you do not have commit access and would like to submit a change proposal please email geotools-devel and a committer can post on your behalf.
 
@@ -113,9 +108,9 @@ Websites
 GeoTools maintains a number of public websites.
 
 ============================================= =========================================== ============
-http://geotools.org/                          GeoTools website                            OSGeo
-http://geotoolsnews.blogspot.com/             GeoTools Blog                               Blogger
-http://sourceforge.net/projects/geotools/     Used for project downloads.                 SourceForge
+https://geotools.org/                         GeoTools website                            OSGeo
+https://geotoolsnews.blogspot.com/            GeoTools Blog                               Blogger
+https://sourceforge.net/projects/geotools/    Used for project downloads.                 SourceForge
 https://github.com/geotools                   Source code                                 GitHub
 https://osgeo-org.atlassian.net/projects/GEOT JIRA Issue Tracker                          Atlassian
 https://github.com/geotools/geotools/wiki     Wiki for developer collaboration            GitHub
@@ -124,16 +119,11 @@ https://github.com/geotools/geotools/wiki     Wiki for developer collaboration
 GeoTools has entries on a number of other public websites:
 
 * https://www.openhub.net/p/geotools
-* http://freecode.com/projects/geotools/ (no longer being updated)
-* http://live.osgeo.org/en/overview/geotools_overview.html
-* http://www.osgeo.org/geotools
-* http://gis.stackexchange.com/questions/tagged/geotools
+* https://live.osgeo.org/en/overview/geotools_overview.html
+* https://www.osgeo.org/geotools
+* https://gis.stackexchange.com/questions/tagged/geotools
+* https://zenodo.org/records/5854676 (Digital Object Identifier)
 
 We have archived a number of facilities we no longer use:
 
-* http://old.geotools.org/
-* http://docs.codehaus.org/display/GEOTDOC/Home
-* http://docs.codehaus.org/display/GEOT/Home
-* http://svn.osgeo.org/geotools/trunk
-* http://svn.geotools.org/
-
+* https://svn.osgeo.org/geotools/trunk
diff --git a/docs/developer/procedures/build_server.rst b/docs/developer/procedures/build_server.rst
@@ -1,10 +1,10 @@
-Continuous Integration
-==========================
+Build Server
+============
 
 THe GeoTools code base is monitored by build server which will schedule a compile shortly after each commit is made.
 
-The results of a failed build are emailed to the geotools developer list. And again when the build is fixed.
+The results of a failed build are emailed to the `osgeo forum <https://discourse.osgeo.org/c/geoserver/build/67>`__, and again when the build is fixed.
 
-* Linux Build Server: https://build.geoserver.org/
+* https://build.geoserver.org/
 
 If you require access to the above sever (in order to kick off a job manually) please contact a PMC member for appropriate credentials.
diff --git a/docs/developer/procedures/release.rst b/docs/developer/procedures/release.rst
@@ -348,11 +348,6 @@ Cut and paste from the blog post to the following:
 3. Open Source Geospatial Foundation
    
     Only to be used for "significant" releases (Major release only, not for milestone
-    or point releases)
+    or point releases).
     
-    https://www.osgeo.org/content/news/submit_news.html
-    
-4. Post a message to the osgeo news email list (you are subscribed right?)
-   
-   * To: news_item@osgeo.org
-   * Subject: GeoTools 26.1 Released
+    https://www.osgeo.org/foundation-news/
diff --git a/docs/user/build/maven/snapshots.rst b/docs/user/build/maven/snapshots.rst
@@ -26,12 +26,14 @@ The above example skipped running the tests (which is common when you are trying
 Publish GeoTools SNAPSHOT
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-If you are working on GeoServer or uDig or another project that depends on the latest greatest
-GeoTools release you will need to know how to deploy a SNAPSHOT (so members of your developer
-community do not get compile errors).
+If you are working on GeoServer or another project that depends on the latest greatest
+GeoTools release you will need to know how to deploy a SNAPSHOT to ``https://repo.osgeo.org/``
+(so members of your developer community do not get compile errors). 
 
-The build server ``build.geoserver.org`` is watching the repository, and will
-build and deploy a snapshot. If you really cannot wait:
+The build server ``build.geoserver.org`` is watching the github repository, and will
+build and deploy a SNAPSHOT.
+
+If you really cannot wait:
 
 1. Update to make sure you are not missing out on anyone’s work::
      
@@ -52,7 +54,6 @@ build and deploy a snapshot. If you really cannot wait:
 4. Ensure your ``~/.m2/settings.xml`` has your webdav credentials.
    
      * ``osgeo`` - this is the same as your OSGeo credentials 
-     * ``boundlessgeo`` - ask on the developer email list
    
    The ``settings.xml`` should list both::
    
@@ -65,11 +66,6 @@ build and deploy a snapshot. If you really cannot wait:
              <username>USERID</username>
              <password>PASSWORD</password>
            </server> 
-           <server>
-             <id>boundlessgeo</id>
-             <username>USERID</username>
-             <password>PASSWOD</password>
-           </server>
           </servers>
       </settings>
 
diff --git a/docs/user/welcome/support.rst b/docs/user/welcome/support.rst
@@ -9,30 +9,23 @@ The GeoTools Users email list is a great place to start out; ask questions and s
 The users list is for questions regarding the installation or use of the GeoTools library. Users of GeoTools are usually Java developers building applications with spatial capabilities.
 
 * https://lists.sourceforge.net/lists/listinfo/geotools-gt2-users
-* http://sourceforge.net/mailarchive/forum.php?forum_name=geotools-gt2-users
+* https://sourceforge.net/mailarchive/forum.php?forum_name=geotools-gt2-users
 
-Sometimes, some small applications or server-side code will exist within the GeoTools code base (for example, a Web Map Service implementation or a conversion utility). If these have not yet found a project of their own, then questions about how to use them may be directed to this list.
+Although GeoTools is primarily a Java library, it is also used to host some small tools or server-side code (for example a refactoring script, or a format conversion utility). If these have not yet found a project of their own, then questions about how to use these tools may be directed to this list.
 
-Internet Relay Chat
--------------------
+Developer Chat
+--------------
 
-The GeoTools community is available on IRC for a little bit of Question and Answer. You can often
-find active developers, helpful users, and all manner of activity.
+GeoTools has a developer chat on Gitter:
 
-If you are new to IRC, you will need to find an IRC client (Pidgin, mIRC, or even Colloquy on mac).
+* `https://matrix.to/#/#geotools_geotools:gitter.im <https://matrix.to/#/#geotools_geotools:gitter.im>`__
 
-* ``irc://irc.freenode.net/geotools``
-
-The information you need to configure your IRC client are:
-
-* Server - Pick one from FreeNode Servers
-* Channel - ``#geotools``
-* Port - ``6667``
+This is used on occasion when email is too slow - this is also a suitable venue for development questions.
 
 Question and Answer Forums
 --------------------------
 
-A recent fad is the advent of question and answer forums, while these websites are not an official means of communication they do offer an advantage over the traditional email list in that good answers can be voted relevant.
+While question and answer forums are not an official means of communication they do offer an advantage over the traditional email list in that good answers can be voted relevant.
 
 Tips for use:
 
@@ -42,8 +35,8 @@ Tips for use:
 
 Here are some forums we are aware of at this time:
 
-* http://gis.stackexchange.com/questions/tagged/geotools
-* http://stackoverflow.com/questions/tagged/geotools
+* https://gis.stackexchange.com/questions/tagged/geotools
+* https://stackoverflow.com/questions/tagged/geotools
 
 .. _commercial-support:
 
@@ -55,9 +48,6 @@ please consider setting up a support contract with any of the following organiza
 
 * `Camptocamp <http://www.camptocamp.com/en/services/support>`_
 * `GeoSolutions <https://www.geo-solutions.it/offer/>`_
-* `LISAsoft <http://lisasoft.com/lisasoft-support-services-software-support>`_
-* `OpenGeo <http://opengeo.org/support/>`_
-* `Astun Technology, UK <https://astuntechnology.com/services/#open-source-support>`_
 * `Ian Turton, UK <https://www.ianturton.com>`_
 
 Please consider this as an option, especially if you do not have a background in Geospatial Science
@@ -72,11 +62,11 @@ and improvements.
 
 To create an issue:
 
-1. [Log In](https://osgeo-org.atlassian.net/login) to ``<osgeo-org.atlassian.net>``.
+1. `Log In <https://osgeo-org.atlassian.net/login>`__ to ``<osgeo-org.atlassian.net>``.
    
-   * If this is your first time you can [create an account](https://osgeo-org.atlassian.net/admin/users/sign-up) using the link at the bottom of the Sign In screen.
+   * If this is your first time you can `create an account <https://osgeo-org.atlassian.net/admin/users/sign-up>`__ using the link at the bottom of the Sign In screen.
 
-3. Once logged in you can [Create](https://osgeo-org.atlassian.net/secure/CreateIssue!default.jspa) an issue from the button at the top of the page
+3. Once logged in you can `Create <https://osgeo-org.atlassian.net/secure/CreateIssue!default.jspa>`__ an issue from the button at the top of the page
    
    * Navigate to the `GeoTools JIRA page <https://osgeo-org.atlassian.net/projects/GEOT>`_
    * Press the **Create** at the top of the page
