Discourse 遷移指南¶
目前遷移狀態：Discourse 已重新上線，網址為：https://discourse.llvm.org。舊網址仍然可以使用。我們已知曉回覆合併前郵件時電子郵件回覆有問題。一旦我們有更多資訊，我們會更新。¶
本文檔旨在幫助 LLVM 使用者從郵件列表遷移到 Discourse。Discourse 有兩種基本的互動方式：透過 網頁 UI 和透過電子郵件。
設定您的帳戶¶
最簡單的方式是使用您的 GitHub 帳戶建立帳戶
導航至 https://llvm.discourse.group/
點擊右上角的「註冊」。
在右側選擇「使用 GitHub」並使用您的 GitHub 帳戶登入。
Discourse 的結構¶
Discourse 的結構類似於一組郵件列表，但是那裡使用了不同的術語。為了幫助轉換，這裡有一個術語翻譯表
| 郵件列表 | Discourse |
|---|---|
| 郵件列表，由 threads 組成 | 類別，由 topics 組成 |
| thread，由 emails 組成 | topic，由 posts 組成 |
| 電子郵件 | 貼文 |
設定電子郵件互動¶
有些人希望完全透過他們的電子郵件程式與 Discourse 互動。以下是典型的使用案例
您可以訂閱類別或 topic
您可以回覆貼文，包括引用其他人的文字（在 GMail 上測試過）。
您可以使用
List-ID電子郵件標頭欄位，在您的電子郵件客戶端中依類別篩選收到的電子郵件。您可以使用特定於類別的電子郵件地址，透過電子郵件建立 topics。每個類別描述都會顯示要使用的電子郵件地址，或者您可以使用下面的映射。
電子郵件地址到 Discourse 類別的映射¶
使用這些電子郵件地址，透過電子郵件在特定的 Discourse 類別中建立 topic。您必須擁有與您發送電子郵件的電子郵件地址相關聯的 Discourse 帳戶，否則電子郵件將被拒絕。
| Discourse 類別 | 電子郵件地址 |
|---|---|
| 初學者 | beginners@discourse.llvm.org |
| LLVM 專案 | llvmproject@discourse.llvm.org |
| IR & 最佳化 | IR.Optimizations@discourse.llvm.org |
| IR & 最佳化 - 迴圈最佳化 | IR.Optimizations-Loops@discourse.llvm.org |
| 程式碼產生 | codegen@discourse.llvm.org |
| 程式碼產生 - AMDGPU | codegen-amdgpu@discourse.llvm.org |
| 程式碼產生 - 通用基礎架構 | codegen-common@discourse.llvm.org |
| 程式碼產生 - AArch64 | codegen-aarch64@discourse.llvm.org |
| 程式碼產生 - Arm | codegen-arm@discourse.llvm.org |
| 程式碼產生 - PowerPC | codegen-powerpc@discourse.llvm.org |
| 程式碼產生 - RISCV | codegen-riscv@discourse.llvm.org |
| 程式碼產生 - WebAssembly | codegen-webassembly@discourse.llvm.org |
| 程式碼產生 - X86 | codegen-x86@discourse.llvm.org |
| Clang 前端 | clang@discourse.llvm.org |
| Clang 前端 - 使用 Clang | clang-users@discourse.llvm.org |
| Clang 前端 - clangd | clangd@discourse.llvm.org |
| Clang 前端 - 建置 Clang | clang-build@discourse.llvm.org |
| Clang 前端 - 靜態分析器 | clang-staticanalyzer@discourse.llvm.org |
| 執行時期 | runtimes@discourse.llvm.org |
| 執行時期 - C++ | runtimes-cxx@discourse.llvm.org |
| 執行時期 - Sanitizers | runtimes-sanitizers@discourse.llvm.org |
| 執行時期 - C | runtimes-c@discourse.llvm.org |
| 執行時期 - OpenMP | runtimes-openmp@discourse.llvm.org |
| 執行時期 - OpenCL | runtimes-opencl@discourse.llvm.org |
| MLIR | mlir@discourse.llvm.org |
| MLIR - 公告 | mlir-announce@discourse.llvm.org |
| MLIR - 電子報 | mlir-news@discourse.llvm.org |
| MLIR - TCP-WG | mlir-tcpwg@discourse.llvm.org |
| 子專案 | subprojects@discourse.llvm.org |
| 子專案 - Polly | polly@discourse.llvm.org |
| 子專案 - LLDB | lldb@discourse.llvm.org |
| 子專案 - LLD | lld@discourse.llvm.org |
| 子專案 - Flang | flang@discourse.llvm.org |
| 子專案 - Bolt | bolt@discourse.llvm.org |
| 專案基礎架構 | infra@discourse.llvm.org |
| 專案基礎架構 - 發布測試人員 | infra-release-testers@discourse.llvm.org |
| 專案基礎架構 - 網站 | infra-website@discourse.llvm.org |
| 專案基礎架構 - 文件 | infra-docs@discourse.llvm.org |
| 專案基礎架構 - GitHub | infra-github@discourse.llvm.org |
| 專案基礎架構 - 程式碼審查 | infra-codereview@discourse.llvm.org |
| 專案基礎架構 - Discord | infra-discord@discourse.llvm.org |
| 專案基礎架構 - 郵件列表與論壇 | infra-mailinglists@discourse.llvm.org |
| 專案基礎架構 - IRC | infra-irc@discourse.llvm.org |
| 專案基礎架構 - 基礎架構工作組 | infra-iwg@discourse.llvm.org |
| 社群 | community@discourse.llvm.org |
| 社群 - 編譯器與工具界的女性 | wict@discourse.llvm.org |
| 社群 - 職位發布 | community-jobs@discourse.llvm.org |
| 社群 - 美國 LLVM 開發者會議 | devmtg-US@discourse.llvm.org |
| 社群 - EuroLLVM | devmtg-euro@discourse.llvm.org |
| 社群 - GSOC | gsoc@discourse.llvm.org |
| 社群 - Community.o | community-dot-o@discourse.llvm.org |
| 社群 - LLVM 基金會 | foundation@discourse.llvm.org |
| 社群 - 電子報 | newsletters@discourse.llvm.org |
| 孵化器 | incubator@discourse.llvm.org |
| 孵化器 - CIRCT | circt@discourse.llvm.org |
| 孵化器 - Torch-MLIR | torch-mlir@discourse.llvm.org |
| 孵化器 - Enzyme | enzyme@discourse.llvm.org |
| 意見回饋 | feedback@discourse.llvm.org |
郵件列表到類別的映射¶
此表格說明從郵件列表到 Discourse 中類別的映射。在遷移之後，這些類別的電子郵件地址將保持不變。過時的列表將在 Discourse 遷移過程中變成唯讀。
| 郵件列表 | Discourse 中的類別 |
|---|---|
| All-commits | 目前沒有遷移 |
| Bugs-admin | 目前沒有遷移 |
| cfe-commits | 目前沒有遷移 |
| cfe-dev | Clang 前端 |
| cfe-users | Clang 前端/使用 Clang |
| clangd-dev | Clang 前端/clangd |
| devmtg-organizers | 已過時 |
| Docs | 已過時 |
| eurollvm-organizers | 已過時 |
| flang-commits | 目前沒有遷移 |
| flang-dev | 子專案/Flang Fortran 前端 |
| gsoc | 已過時 |
| libc-commits | 目前沒有遷移 |
| libc-dev | 執行時期/C |
| Libclc-dev | 執行時期/OpenCL |
| libcxx-bugs | 目前沒有遷移 |
| libcxx-commits | 目前沒有遷移 |
| libcxx-dev | 執行時期/C++ |
| lldb-commits | 目前沒有遷移 |
| lldb-dev | 子專案/lldb |
| llvm-admin | 目前沒有遷移 |
| llvm-announce | 公告 |
| llvm-branch-commits | 目前沒有遷移 |
| llvm-bugs | 目前沒有遷移 |
| llvm-commits | 目前沒有遷移 |
| llvm-dev | 專案基礎架構/LLVM 開發列表存檔 |
| llvm-devmeeting | 社群/美國開發者會議 |
| llvm-foundation | 社群/LLVM 基金會 |
| Mlir-commits | 目前沒有遷移 |
| Openmp-commits | 目前沒有遷移 |
| Openmp-dev | 執行時期/OpenMP |
| Parallel_libs-commits | 目前沒有遷移 |
| Parallel_libs-dev | 執行時期/C++ |
| Release-testers | 專案基礎架構/發布測試人員 |
| Test-list | 已過時 |
| vmkit-commits | 已過時 |
| WiCT | 社群/編譯器與工具界的女性 |
| www-scripts | 已過時 |
常見問題¶
我不想使用網頁 UI¶
您可以使用您的電子郵件客戶端進行大多數的溝通（請參閱上面關於設定電子郵件互動的章節）。您只需要設定一次您的帳戶，然後配置您想要訂閱的類別。
如何發送私人訊息？¶
在郵件列表中，您有機會僅回覆電子郵件的發送者，而不是整個列表。透過電子郵件在 Discourse 上回覆時，不支援此功能。但是，您可以透過網頁 UI 向某人發送私人訊息：點擊貼文上方的使用者名稱，然後點擊 訊息。
此外，Discourse 不會公開使用者的電子郵件地址，因此您的私人回覆必須透過他們的平台進行（除非您碰巧知道使用者的電子郵件地址）。
我的腳本/工具如何發送自動訊息？**¶
如果您想從腳本或工具自動建立新的貼文/topic，您可以使用 Discourse API。
誰是 Discourse 的管理員？¶
請參閱 https://llvm.discourse.group/about
遷移的原因是什麼？¶
請參閱這封電子郵件
如何設定私人郵件列表？¶
我們的電子郵件存檔會發生什麼事？¶
Mailman 存檔目前將保留在網頁伺服器上。
Discourse 相較於目前的郵件列表有什麼優勢？¶
使用者可以發布到任何類別，即使沒有訂閱。
網頁 UI 上的全文檢索。
透過網頁 UI 發送/回覆（電子郵件仍然可行）。
在一個頁面上查看整個 thread。
相較於建立新的郵件列表，類別是更輕量級的選項，用於組織討論。
使用 GitHub 單一登入。
使用者電子郵件地址保持私密。
我還有其他這裡未涵蓋的問題。我該怎麼辦？¶
請聯絡 iwg@llvm.org 或在 GitHub 上提出 issue 工單。