From dff1678b48a769da31f15870e22048ae9902eccd Mon Sep 17 00:00:00 2001
From: Cory Quammen <cory.quammen@kitware.com>
Date: Tue, 19 Feb 2019 19:37:11 -0500
Subject: [PATCH] doc: update reference to the mailing lists
Change references to the mailing list to the VTK Discourse forum.
---
CONTRIBUTING.md | 4 ++--
Documentation/Doxygen/ArrayDispatch-VTK-7-1.md | 4 +++-
Documentation/dev/git/dashboard.md | 5 ++++-
Documentation/maint/release.md | 9 ++++++---
Examples/GUI/Cocoa/Documentation/Instructions.rtf | 6 +++---
Examples/README.txt | 8 ++++----
Parallel/MPI/vtkMPICommunicator.cxx | 2 +-
README.md | 8 ++++----
ThirdParty/UPDATING.md | 6 ++++--
Utilities/Doxygen/doc_version.pl | 3 +--
10 files changed, 32 insertions(+), 23 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 11afdcaf970..9ffa831ff65 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -60,7 +60,7 @@ patches before they are merged.
Our [Wiki] is used to document features, flesh out designs and host other
documentation. Our API is documented using [Doxygen] with updated
-documentation generated nightly. We have several [Mailing Lists]
+documentation generated nightly. We have a [VTK Discourse] forum
to coordinate development and to provide support.
[VTK Git README]: Documentation/dev/git/README.md
@@ -76,4 +76,4 @@ to coordinate development and to provide support.
[Wiki]: http://www.vtk.org/Wiki/VTK
[Doxygen]: http://www.vtk.org/doc/nightly/html
-[Mailing Lists]: http://www.vtk.org/VTK/help/mailing.html
+[VTK Discourse]: https://discourse.vtk.org/
diff --git a/Documentation/Doxygen/ArrayDispatch-VTK-7-1.md b/Documentation/Doxygen/ArrayDispatch-VTK-7-1.md
index 94f5cf32c55..608970dedec 100644
--- a/Documentation/Doxygen/ArrayDispatch-VTK-7-1.md
+++ b/Documentation/Doxygen/ArrayDispatch-VTK-7-1.md
@@ -1274,4 +1274,6 @@ restrictions are not met.
Hopefully this has convinced you that the `vtkArrayDispatch` and related tools
are worth using to create flexible, efficient, typesafe implementations for
your work with VTK. Please direct any questions you may have on the subject to
-the VTK mailing lists.
+the [VTK Discourse][] forum.
+
+[VTK Discourse]: https://discourse.vtk.org
diff --git a/Documentation/dev/git/dashboard.md b/Documentation/dev/git/dashboard.md
index 83167a02056..42e6c58de37 100644
--- a/Documentation/dev/git/dashboard.md
+++ b/Documentation/dev/git/dashboard.md
@@ -42,4 +42,7 @@ Make your edits, test it, and commit the result. Create a patch file with:
$ git format-patch origin/dashboard
-And email the results to the developer's mailing list.
+And post the results in the [Development][] category in the [VTK Discourse][] forum.
+
+[Development]: https://discourse.vtk.org/c/development
+[VTK Discourse]: https://discourse.vtk.org/
diff --git a/Documentation/maint/release.md b/Documentation/maint/release.md
index 86ecb57fc39..8633bce5b79 100644
--- a/Documentation/maint/release.md
+++ b/Documentation/maint/release.md
@@ -22,12 +22,12 @@ another for rc1). Plausible deadlines should be used; they can be edited later.
### Annoucements
-Announcements should be sent to developers first and Linux distribution
+Announcements should be posted on the [VTK Discourse][] forum and Linux distribution
maintainers.
-#### Mailing List
+#### VTK Community Announcement
-Announce to the developer list (vtk-developers@vtk.org) that a release is being
+Announce to the [Development][] category that a release is being
planned. Template:
Hi,
@@ -341,3 +341,6 @@ Send an email to `vtk-developers@vtk.org`, `vtkusers@vtk.org`. Also inform
For the final release, a blog post, release notes, and a Source article should
be made.
+
+[VTK Discourse]: https://discourse.vtk.org
+[Development]: https://discourse.vtk.org/c/development
diff --git a/Examples/GUI/Cocoa/Documentation/Instructions.rtf b/Examples/GUI/Cocoa/Documentation/Instructions.rtf
index ec0d876e457..64e1eef4add 100644
--- a/Examples/GUI/Cocoa/Documentation/Instructions.rtf
+++ b/Examples/GUI/Cocoa/Documentation/Instructions.rtf
@@ -52,8 +52,8 @@ Now you should be able to build the project!\
\
The code has many comments, and hopefully they will answer any questions you may have.\
\
-If you have any problems, please post to the vtkusers mailing list.\
-<{\field{\*\fldinst{HYPERLINK "https://public.kitware.com/mailman/listinfo/vtkusers"}}{\fldrslt https://public.kitware.com/mailman/listinfo/vtkusers}}>\
+If you have any problems, please post to the VTK Discourse forum.\
+<{\field{\*\fldinst{HYPERLINK "https://discourse.vtk.org"}}{\fldrslt https://discourse.vtk.org}}>\
\
\ul \ulc0 Version History:\
\ulnone \
@@ -153,4 +153,4 @@ Changes in 1.1 (since 1.0)\
- minor code cleanup\
- added call to print out any leaking vtk objects\
- linked to Ryan Glover's great instructions on how to build vtk\
-}
\ No newline at end of file
+}
diff --git a/Examples/README.txt b/Examples/README.txt
index 5d0e9d2e45d..8d7dfcb88a1 100644
--- a/Examples/README.txt
+++ b/Examples/README.txt
@@ -55,10 +55,10 @@ Additional Resources
* The VTK Testing directories (e.g., VTK/Graphics/Testing) contain other
examples. These are not commented, and designed for testing.
-* The VTK Mailing List http://public.kitware.com/mailman/listinfo/vtkusers
+* The VTK Discourse forum http://discourse.vtk.org/
-* The VTK Web Pages http://public.kitware.com/
+* The VTK Web Pages https://vtk.org/Wiki/VTK
* Commercial support and resources from Kitware:
- - The VTK User's Guide http://www.kitware.com/products/vtkguide.html
- - Support Contracts http://www.kitware.com/products/vtksupport.html
+ - The VTK User's Guide https://vtk.org/documentation/
+ - Support Contracts https://www.kitware.com/what-we-offer/#support
diff --git a/Parallel/MPI/vtkMPICommunicator.cxx b/Parallel/MPI/vtkMPICommunicator.cxx
index 55d2926ef70..c491bc2dd37 100644
--- a/Parallel/MPI/vtkMPICommunicator.cxx
+++ b/Parallel/MPI/vtkMPICommunicator.cxx
@@ -123,7 +123,7 @@ inline MPI_Datatype vtkMPICommunicatorGetMPIType(int vtkType)
case VTK_ID_TYPE: return MPI_LONG_LONG;
#else
case VTK_ID_TYPE:
- vtkGenericWarningMacro("This systems MPI doesn't seem to support 64 bit ids and you have 64 bit IDs turned on. Please contact VTK mailing list.");
+ vtkGenericWarningMacro("This systems MPI doesn't seem to support 64 bit ids and you have 64 bit IDs turned on. Please seek assistance on the VTK Discourse (https://discourse.vtk.org/).");
return MPI_LONG;
#endif
#else //VTK_USE_64BIT_IDS
diff --git a/README.md b/README.md
index 53b2d0aff54..cd4c6aa10aa 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ Learning Resources
* General information is available at the [VTK Homepage][].
-* Community discussion takes place on the [VTK Mailing Lists][].
+* Community discussion takes place on the [VTK Discourse][] forum.
* Commercial [support][Kitware Support] and [training][Kitware Training]
are available from [Kitware][].
@@ -34,9 +34,9 @@ Learning Resources
* Doxygen-generated nightly reference documentation is
available [online][Doxygen].
-[VTK Homepage]: https://www.vtk.org
+[VTK Homepage]: https://www.vtk.org/
[Doxygen]: https://www.vtk.org/doc/nightly/html
-[VTK Mailing Lists]: https://www.vtk.org/mailing-lists/
+[VTK Discourse]: https://discourse.vtk.org/
[Kitware]: https://www.kitware.com/
[Kitware Support]: https://www.kitware.com/what-we-offer/#support
[Kitware Training]: https://www.kitware.com/what-we-offer/#training
@@ -48,7 +48,7 @@ If you have found a bug:
1. If you have a patch, please read the [CONTRIBUTING.md][] document.
-2. Otherwise, please join the one of the [VTK Mailing Lists][] and ask
+2. Otherwise, please join the [VTK Discourse][] forum and ask
about the expected and observed behaviors to determine if it is
really a bug.
diff --git a/ThirdParty/UPDATING.md b/ThirdParty/UPDATING.md
index ad5cce96e2e..e05a02eab2d 100644
--- a/ThirdParty/UPDATING.md
+++ b/ThirdParty/UPDATING.md
@@ -116,5 +116,7 @@ subdirectory using the `subtree` merge strategy.
Initial conversions will require a manual push by the maintainers since the
conversion involves a root commit which is not allowed under normal
-circumstances. Please send an email to the mailing list asking for assistance
-if necessary.
+circumstances. Please post a message on the [VTK Discourse][] forum asking
+for assistance if necessary.
+
+[VTK Discourse]: https://discourse.vtk.org/
diff --git a/Utilities/Doxygen/doc_version.pl b/Utilities/Doxygen/doc_version.pl
index f9070396b1e..a29975c3e9f 100755
--- a/Utilities/Doxygen/doc_version.pl
+++ b/Utilities/Doxygen/doc_version.pl
@@ -173,8 +173,7 @@ print DEST_FILE
" \@par Useful links:\n",
" \@li VTK Home: http://www.vtk.org\n",
" \@li VTK Source: https://gitlab.kitware.com/vtk/vtk\n",
- " \@li VTK Users Mailing List: http://www.vtk.org/mailman/listinfo/vtkusers\n",
- " \@li VTK Developer Mailing List: http://www.vtk.org/mailman/listinfo/vtk-developers\n",
+ " \@li VTK Discourse Forum: https://discourse.vtk.org\n",
" \@li VTK FAQ: http://www.vtk.org/Wiki/VTK_FAQ\n",
" \@li VTK Wiki: http://www.vtk.org/Wiki/\n",
" \@li VTK Dashboard: http://www.cdash.org/CDash/index.php?project=VTK\n",
--
GitLab