Skip to content

Commit ca8432f

Browse files
committed
Update references to the mailing list to reference Discourse. Also update references to LLVM Bugzilla as we have moved to GitHub issues.
Reviewed By: lattner Differential Revision: https://reviews.llvm.org/D120833
1 parent 210bdc6 commit ca8432f

File tree

1 file changed

+20
-26
lines changed

1 file changed

+20
-26
lines changed

llvm/docs/DeveloperPolicy.rst

Lines changed: 20 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -46,12 +46,8 @@ quality.
4646
Stay Informed
4747
-------------
4848

49-
Developers should stay informed by reading at least the "dev" mailing list for
50-
the projects you are interested in, such as `llvm-dev
51-
<http://lists.llvm.org/mailman/listinfo/llvm-dev>`_ for LLVM, `cfe-dev
52-
<http://lists.llvm.org/mailman/listinfo/cfe-dev>`_ for Clang, or `lldb-dev
53-
<http://lists.llvm.org/mailman/listinfo/lldb-dev>`_ for LLDB. If you are
54-
doing anything more than just casual work on LLVM, it is suggested that you also
49+
Developers should stay informed by reading the `LLVM Discourse forums`_.
50+
If you are doing anything more than just casual work on LLVM, it is suggested that you also
5551
subscribe to the "commits" mailing list for the subproject you're interested in,
5652
such as `llvm-commits
5753
<http://lists.llvm.org/mailman/listinfo/llvm-commits>`_, `cfe-commits
@@ -61,14 +57,13 @@ such as `llvm-commits
6157
way to see what other people are interested in and watching the flow of the
6258
project as a whole.
6359

64-
We recommend that active developers register an email account with `LLVM
65-
Bugzilla <https://bugs.llvm.org/>`_ and preferably subscribe to the `llvm-bugs
60+
We recommend that active developers monitor incoming issues to our `GitHub issue tracker <https://github.com/llvm/llvm-project/issues>`_ and preferably subscribe to the `llvm-bugs
6661
<http://lists.llvm.org/mailman/listinfo/llvm-bugs>`_ email list to keep track
6762
of bugs and enhancements occurring in LLVM. We really appreciate people who are
6863
proactive at catching incoming bugs in their components and dealing with them
6964
promptly.
7065

71-
Please be aware that all public LLVM mailing lists are public and archived, and
66+
Please be aware that all public LLVM mailing lists and discourse forums are public and archived, and
7267
that notices of confidentiality or non-disclosure cannot be respected.
7368

7469
.. _patch:
@@ -219,7 +214,7 @@ the future that the change is responsible for. For example:
219214
* The changes should not cause performance or correctness regressions in code
220215
compiled by LLVM on all applicable targets.
221216

222-
* You are expected to address any `Bugzilla bugs <https://bugs.llvm.org/>`_ that
217+
* You are expected to address any `GitHub Issues <https://github.com/llvm/llvm-project/issues>`_ that
223218
result from your change.
224219

225220
We prefer for this to be handled before submission but understand that it isn't
@@ -281,7 +276,7 @@ Below are some guidelines about the format of the message itself:
281276
code snippets and gory details should be left to bug comments, web
282277
review or the mailing list.
283278

284-
* If the patch fixes a bug in bugzilla, please include the PR# in the message.
279+
* If the patch fixes a bug in GitHub Issues, please include the PR# in the message.
285280

286281
* Text formatting and spelling should follow the same rules as documentation
287282
and in-code comments, ex. capitalization, full stop, etc.
@@ -435,8 +430,7 @@ Making a Major Change
435430
---------------------
436431

437432
When a developer begins a major new project with the aim of contributing it back
438-
to LLVM, they should inform the community with an email to the `llvm-dev
439-
<http://lists.llvm.org/mailman/listinfo/llvm-dev>`_ email list, to the extent
433+
to LLVM, they should inform the community with a post to the `LLVM Discourse forums`_, to the extent
440434
possible. The reason for this is to:
441435

442436
#. keep the community informed about future changes to LLVM,
@@ -593,7 +587,7 @@ C API Changes
593587
* Including new things into the API: If an LLVM subcomponent has a C API already
594588
included, then expanding that C API is acceptable. Adding C API for
595589
subcomponents that don't currently have one needs to be discussed on the
596-
mailing list for design and maintainability feedback prior to implementation.
590+
`LLVM Discourse forums`_ for design and maintainability feedback prior to implementation.
597591

598592
* Documentation: Any changes to the C API are required to be documented in the
599593
release notes so that it's clear to external users who do not follow the
@@ -613,7 +607,7 @@ will only be done through the following process:
613607
at a minimum. This time-based guideline is not strict: we may support much
614608
older compilers, or decide to support fewer versions.
615609

616-
* An RFC is sent to the `llvm-dev mailing list`_
610+
* An RFC is sent to the `LLVM Discourse forums`_
617611

618612
- Detail upsides of the version increase (e.g. which newer C++ language or
619613
library features LLVM should use; avoid miscompiles in particular compiler
@@ -625,7 +619,7 @@ will only be done through the following process:
625619
softer transition path for developers compiling LLVM, because the
626620
error can be turned into a warning using a CMake flag. This is an important
627621
step: LLVM still doesn't have code which requires the new toolchains, but it
628-
soon will. If you compile LLVM but don't read the mailing list, we should
622+
soon will. If you compile LLVM but don't read the forums, we should
629623
tell you!
630624

631625
* Ensure that at least one LLVM release has had this soft-error. Not all
@@ -640,7 +634,7 @@ will only be done through the following process:
640634
* Start using the new features in LLVM's codebase.
641635

642636
Here's a `sample RFC
643-
<http://lists.llvm.org/pipermail/llvm-dev/2019-January/129452.html>`_ and the
637+
<https://discourse.llvm.org/t/rfc-migrating-past-c-11/50943>`_ and the
644638
`corresponding change <https://reviews.llvm.org/D57264>`_.
645639

646640
.. _ci-usage:
@@ -707,7 +701,7 @@ than *peripheral* projects, and the latter may have additional differences.
707701
However, this is really only intended to cover common cases
708702
that we have seen arise: different situations are different, and we are open
709703
to discussing unusual cases as well - just start an RFC thread on the
710-
`llvm-dev mailing list`_.
704+
`LLVM Discourse forums`_.
711705

712706
Adding a New Target
713707
-------------------
@@ -802,7 +796,7 @@ Those wishing to add a new target to LLVM must follow the procedure below:
802796
1. Read this section and make sure your target follows all requirements. For
803797
minor issues, your community will be responsible for making all necessary
804798
adjustments soon after the initial merge.
805-
2. Send a request for comment (RFC) to the llvm-dev@ mailing list, describing
799+
2. Send a request for comment (RFC) to the `LLVM Discourse forums`_ describing
806800
your target and how it follows all the requirements and what work has been
807801
done and will need to be done to accommodate the official target requirements.
808802
Make sure to expose any and all controversial issues, changes needed in the
@@ -825,7 +819,7 @@ Those wishing to add a new target to LLVM must follow the procedure below:
825819
sure the progress is still consistent.
826820
7. Once all official requirements have been fulfilled (as above), the code owner
827821
should request the target to be enabled by default by sending another RFC to
828-
the llvm-dev@ mailing list.
822+
the `LLVM Discourse forums`_.
829823

830824
Adding an Established Project To the LLVM Monorepo
831825
--------------------------------------------------
@@ -860,7 +854,7 @@ components to a high bar similar to "official targets", they:
860854
"should" concerns above.
861855

862856
If you have a project that you think would make sense to add to the LLVM
863-
monorepo, please start an RFC thread on the `llvm-dev mailing list`_ to kick off
857+
monorepo, please start an RFC topic on the `LLVM Discourse forums`_ to kick off
864858
the discussion. This process can take some time and iteration - please don’t
865859
be discouraged or intimidated by that!
866860

@@ -919,10 +913,10 @@ When approved, the llvm-admin group can grant the new project:
919913
Graduation to the mono-repo would follow existing processes and standards for
920914
becoming a first-class part of the monorepo. Similarly, an incubating project
921915
may be eventually retired, but no process has been established for that yet. If
922-
and when this comes up, please start an RFC discussion on llvm-dev.
916+
and when this comes up, please start an RFC discussion on the `LLVM Discourse forums`_.
923917

924918
This process is very new - please expect the details to change, it is always
925-
safe to ask on the `llvm-dev mailing list`_ about this.
919+
safe to ask on the `LLVM Discourse forums`_ about this.
926920

927921
Suggested disclaimer for the project README and the main project web page:
928922

@@ -957,8 +951,8 @@ process to take at least 4-6 weeks. If you would like to contribute code
957951
under a different license, please create a Phabricator review with the code
958952
you want to contribute and email [email protected] requesting a review.
959953

960-
If you have questions or comments about these topics, please contact the
961-
`LLVM Developer's Mailing List <mailto:[email protected]>`_. However,
954+
If you have questions or comments about these topics, please ask on the
955+
`LLVM Discourse forums`_. However,
962956
please realize that most compiler developers are not lawyers, and therefore you
963957
will not be getting official legal advice.
964958

@@ -1202,4 +1196,4 @@ to move code from (e.g.) libc++ to the LLVM core without concern, but that code
12021196
cannot be moved from the LLVM core to libc++ without the copyright owner's
12031197
permission.
12041198

1205-
.. _llvm-dev mailing list: http://lists.llvm.org/mailman/listinfo/llvm-dev
1199+
.. _LLVM Discourse forums: https://discourse.llvm.org

0 commit comments

Comments
 (0)