Skip to content

Commit 6480adf

Browse files
rep-0001: replace [email protected] by discourse (ros-infrastructure#336)
* rep-0001: replace [email protected] by discourse The [email protected] mailing list does not exist since 2019. REP proposals should be discussed on discourse.ros.org instead. Co-authored-by: Chris Lalancette <[email protected]>
1 parent 82a914f commit 6480adf

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

rep-0001.rst

+19-17
Original file line numberDiff line numberDiff line change
@@ -68,9 +68,10 @@ There are three kinds of REP:
6868
REP Work Flow
6969
=============
7070

71-
The REP editors assign REP numbers and change their status. Please send
72-
all REP-related email to <[email protected]> (no cross-posting please).
73-
Also see `REP Editor Responsibilities & Workflow`_ below.
71+
The REP editors assign REP numbers and change their status. Please post
72+
all REP-related email to the General section of
73+
`discourse.ros.org <https://discourse.ros.org>`_. Also see `REP Editor
74+
Responsibilities & Workflow`_ below.
7475

7576
The REP process begins with a new idea for ROS. It is highly
7677
recommended that a single REP contain a single key proposal or new
@@ -85,8 +86,9 @@ Each REP must have a champion -- someone who writes the REP using the
8586
style and format described below, shepherds the discussions in the
8687
appropriate forums, and attempts to build community consensus around
8788
the idea. The REP champion (a.k.a. Author) should first attempt to
88-
ascertain whether the idea is REP-able. Posting to the ros-users list
89-
is the best way to go about this.
89+
ascertain whether the idea is REP-able. Posting to
90+
`discourse.ros.org <https://discourse.ros.org>`_ is the best way to go
91+
about this.
9092

9193
Vetting an idea publicly before going as far as writing a REP is meant
9294
to save the potential author time. Many ideas have been brought
@@ -100,13 +102,13 @@ Just because an idea sounds good to the author does not
100102
mean it will work for most people in most areas where ROS is used.
101103

102104
Once the champion has asked the ROS community as to whether an idea
103-
has any chance of acceptance, a draft REP should be presented to
104-
ros-users. This gives the author a chance to flesh out the draft REP
105-
to make properly formatted, of high quality, and to address initial
106-
concerns about the proposal.
105+
has any chance of acceptance, a draft REP should be posted to
106+
`discourse.ros.org <https://discourse.ros.org>`_. This gives the
107+
author a chance to flesh out the draft REP to make properly formatted,
108+
of high quality, and to address initial concerns about the proposal.
107109

108-
Following a discussion on ros-users, the draft REP should be sent to
109-
the ros-users list. The draft must be written in REP style as
110+
Following an initial discussion on Discourse, the draft REP should be
111+
posted to Discourse as well. The draft must be written in REP style as
110112
described below, else it will be sent back without further regard
111113
until proper formatting rules are followed.
112114

@@ -270,7 +272,7 @@ optional and are described below. All other headers are required. ::
270272
* Requires: <rep numbers>
271273
Created: <date created on, in dd-mmm-yyyy format>
272274
* ROS-Version: <version number>
273-
Post-History: <dates of postings to ros-users>
275+
Post-History: <dates of postings to discourse.ros.org>
274276
* Replaces: <rep number>
275277
* Replaced-By: <rep number>
276278
* Resolution: <url>
@@ -302,9 +304,9 @@ other web resource where the pronouncement about the REP is made.*
302304
While a REP is in private discussions (usually during the initial
303305
Draft phase), a Discussions-To header will indicate the mailing list
304306
or URL where the REP is being discussed. No Discussions-To header is
305-
necessary if the REP is being discussed privately with the author, or
306-
on the ros-users email mailing lists. Note that email addresses in
307-
the Discussions-To header will not be obscured.
307+
necessary if the REP is being discussed privately with the author.
308+
Note that email addresses in the Discussions-To header will not be
309+
obscured.
308310

309311
The Type header specifies the type of REP: Standards Track,
310312
Informational, or Process.
@@ -315,8 +317,8 @@ encoding (see REP 12 [2]_).
315317

316318
The Created header records the date that the REP was assigned a
317319
number, while Post-History is used to record the dates of when new
318-
versions of the REP are posted to ros-users. Both headers should be
319-
in dd-mmm-yyyy format, e.g. 14-Aug-2010.
320+
versions of the REP are posted to https://discourse.ros.org. Both headers
321+
should be in dd-mmm-yyyy format, e.g. 14-Aug-2010.
320322

321323
Standards Track REPs must have a ROS-Version header which indicates
322324
the version/distribution of ROS that the feature will be released with.

0 commit comments

Comments
 (0)