docs(wep): the WEP PR is the single discussion venue

leaanthony · leaanthony · commit 850f08ba7409 · 2026-07-07T08:49:17.000+10:00
Per maintainer decision: proposals are discussed on the WEP PR itself
(comments for feedback, thumbs-up reactions for support), not in a
separate discussion thread. Pre-proposal ideas can optionally be
floated in the Ideas category on GitHub Discussions or on Discord.
Index column Discussion renamed to Proposal.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -8,7 +8,7 @@ body:
     attributes:
       value: |
         Before opening a feature request, please check the [Roadmap](https://github.com/wailsapp/wails/discussions/1484) to see if it has already been requested.
-        ***Please note: Enhancements should be discussed in [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) on GitHub Discussions (or on [Discord](https://discord.gg/JDdSxwjhGf)) before opening a feature request. Substantial new functionality should be submitted as a [Wails Enhancement Proposal (WEP)](https://github.com/wailsapp/wails/blob/master/v3/wep/README.md). See the [feedback guide](https://v3.wails.io/feedback/) for details.***
+        ***Please note: Enhancements should be discussed in [Ideas](https://github.com/wailsapp/wails/discussions/categories/ideas) on GitHub Discussions or on [Discord](https://discord.gg/JDdSxwjhGf) before opening a feature request. Substantial new functionality should be submitted as a [Wails Enhancement Proposal (WEP)](https://github.com/wailsapp/wails/blob/master/v3/wep/README.md). See the [feedback guide](https://v3.wails.io/feedback/) for details.***
 
   - type: textarea
     attributes:
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -15,7 +15,7 @@ Thanks for your interest in contributing! Wails has two active tracks. Pick the
 - Docs: [v3.wails.io](https://v3.wails.io/).
 - Detailed contributor guide: [v3.wails.io/contributing](https://v3.wails.io/contributing/).
 - Changelog: v3 entries are added automatically from your PR on merge. To control the wording, add your own entry to `v3/UNRELEASED_CHANGELOG.md` and the automation will use it instead.
-- **Enhancements require prior discussion** in [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) on GitHub Discussions (see the [feedback guide](https://v3.wails.io/feedback/)). Substantial new functionality goes through the [Wails Enhancement Proposal (WEP) process](v3/wep/README.md).
+- **Enhancements require prior discussion** in [Ideas](https://github.com/wailsapp/wails/discussions/categories/ideas) on GitHub Discussions (see the [feedback guide](https://v3.wails.io/feedback/)). Substantial new functionality goes through the [Wails Enhancement Proposal (WEP) process](v3/wep/README.md).
 
 ## Pull request checklist
 
diff --git a/docs/src/content/docs/contributing.mdx b/docs/src/content/docs/contributing.mdx
@@ -42,10 +42,10 @@ Contribute code through pull requests:
 
 Substantial new functionality goes through the Wails Enhancement Proposal (WEP) process. It keeps feature development transparent and ensures every accepted proposal has community support and an implementor. In short:
 
-1. Discuss your idea in the [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) category on GitHub Discussions. This is the official place to discuss proposals. The [#enhancement-proposals](https://discord.gg/TA8kbQds95) channel on Discord is a good place for informal chat about it too.
+1. Optionally float your idea in the [Ideas](https://github.com/wailsapp/wails/discussions/categories/ideas) category on GitHub Discussions or on [Discord](https://discord.gg/JDdSxwjhGf) to gauge interest.
 2. Copy [`v3/wep/WEP_TEMPLATE.md`](https://github.com/wailsapp/wails/blob/master/v3/wep/WEP_TEMPLATE.md) to `v3/wep/proposals/<proposal name>/proposal.md` and fill in every section.
-3. Open a draft pull request titled `[WEP] <title>` containing only the proposal, and link it from your discussion thread.
-4. Gather feedback and support (upvotes on the discussion). Allow at least two weeks for discussion, and agree on who will implement the proposal.
+3. Open a draft pull request titled `[WEP] <title>` containing only the proposal. The PR is the official place to discuss it.
+4. Gather feedback and support (comments and thumbs-up reactions on the PR). Allow at least two weeks for discussion, and agree on who will implement the proposal.
 5. Mark the PR ready for review. The maintainers make the final decision: accepted proposals are assigned a WEP number and merged.
 
 The full process is documented in [`v3/wep/README.md`](https://github.com/wailsapp/wails/blob/master/v3/wep/README.md).
diff --git a/docs/src/content/docs/feedback.mdx b/docs/src/content/docs/feedback.mdx
@@ -47,7 +47,7 @@ discussions before creating new ones. Here are the different ways to contribute:
 
     - Clearly describe the feature and the problem it solves.
     - Feel free to also discuss ideas in the [#v3](https://discord.gg/bdj28QNHmT) channel on Discord.
-    - Substantial new functionality goes through the [Wails Enhancement Proposal (WEP) process](https://github.com/wailsapp/wails/blob/master/v3/wep/README.md), a structured proposal that is discussed with the community before being accepted for implementation. Proposals are discussed in the [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) category on GitHub Discussions. See the [contributing guide](/contributing/#4-propose-an-enhancement-wep) for a summary.
+    - Substantial new functionality goes through the [Wails Enhancement Proposal (WEP) process](https://github.com/wailsapp/wails/blob/master/v3/wep/README.md), a structured proposal that is discussed with the community on its pull request before being accepted for implementation. See the [contributing guide](/contributing/#4-propose-an-enhancement-wep) for a summary.
 
   </TabItem>
 
diff --git a/v3/wep/README.md b/v3/wep/README.md
@@ -18,13 +18,13 @@ Not every change needs a proposal. As a rule of thumb:
 - **WEP required**: new public API, changes to existing API behaviour, breaking changes, new cross-platform functionality, or anything involving significant platform-specific work.
 - **No WEP needed**: bug fixes, documentation, small additive options, internal refactoring. Use the standard PR process.
 
-If you are unsure, start a discussion in the [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) category and ask.
+If you are unsure, ask in the [Ideas](https://github.com/wailsapp/wails/discussions/categories/ideas) category on GitHub Discussions or on [Discord](https://discord.gg/JDdSxwjhGf).
 
 ## Submission of Proposal
 
 ### 1. Idea Initiation
 
-- **Discuss Your Idea**: Before writing a proposal, start a discussion in the [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) category on GitHub Discussions. This is the official place to discuss proposals. It helps gauge interest, catch overlap with existing plans, and shape the idea before you invest time in writing it up.
+- **Gauge Interest (optional)**: Before writing a proposal, consider floating the idea in the [Ideas](https://github.com/wailsapp/wails/discussions/categories/ideas) category on GitHub Discussions or on [Discord](https://discord.gg/JDdSxwjhGf). It can catch overlap with existing plans before you invest time in a write-up.
 - **Document Your Idea**: 
   - Create a new directory: `v3/wep/proposals/<name of proposal>` with the name of your proposal. 
   - Copy the WEP template located in `v3/wep/WEP_TEMPLATE.md` into `v3/wep/proposals/<name of proposal>/proposal.md`. 
@@ -40,9 +40,9 @@ If you are unsure, start a discussion in the [Enhancement Proposals](https://git
 
 ### 3. Community Discussion
 
-- **Share Your Proposal**: Link the PR from your discussion in the [Enhancement Proposals](https://github.com/wailsapp/wails/discussions/categories/enhancement-proposals) category (or start one if you haven't yet). Try to get support for the proposal to increase the chances of acceptance. If you are on the discord server, you are also welcome to share it in the [`#enhancement-proposals`](https://discord.gg/TA8kbQds95) channel, but GitHub Discussions is the official venue.
-- **Gather Feedback**: Refine your proposal based on community input. Feedback on the proposal text itself should be added as comments on the PR so it stays with the document; broader discussion belongs in the discussion thread.
-- **Show Support**: Agreement with the proposal should be indicated by upvoting the discussion in the Enhancement Proposals category. The more support a proposal has, the more likely it is to be accepted.
+- **Share Your Proposal**: The PR is the official place to discuss the proposal. Present it to the Wails community and try to get support for it to increase the chances of acceptance. If you are on the discord server, share it in the [`#enhancement-proposals`](https://discord.gg/TA8kbQds95) channel.
+- **Gather Feedback**: Refine your proposal based on community input. All feedback should be added as comments on the PR so the discussion stays with the document.
+- **Show Support**: Agreement with the proposal should be indicated by adding a thumbs-up reaction to the PR. The more support a proposal has, the more likely it is to be accepted.
 - **Iterate**: Make changes to the proposal based on feedback.
 - **Agree on an Implementor**: To avoid stagnant proposals, we require someone agree to implement it. This could be the proposer.
 - **Ready for Review**: Once the proposal is ready for review, change the PR status to `Ready for Review`.
@@ -91,8 +91,8 @@ Once a proposal has been accepted and an implementation plan has been decided, t
 
 ## WEP Index
 
-| WEP | Title | Status | Discussion | Implementation |
-|-----|-------|--------|------------|----------------|
+| WEP | Title | Status | Proposal | Implementation |
+|-----|-------|--------|----------|----------------|
 | [0001](proposals/0001-titlebar-buttons/proposal.md) | Customising Window Controls | Implemented | [#3508](https://github.com/wailsapp/wails/pull/3508) | [#3508](https://github.com/wailsapp/wails/pull/3508) |
 
 **Statuses**: `Draft` (under discussion), `Accepted` (approved, awaiting implementation), `Implemented` (shipped), `Rejected` (declined), `Withdrawn` (closed by the author or for inactivity).
diff --git a/v3/wep/WEP_TEMPLATE.md b/v3/wep/WEP_TEMPLATE.md
@@ -6,7 +6,7 @@
 **Status**: Draft  
 **Author**: [Your Name]  
 **Created**: [YYYY-MM-DD]  
-**Discussion**: [link to your discussion in the Enhancement Proposals category]  
+**Discussion**: [optional link to any prior discussion of the idea]  
 **Implementor**: [who has agreed to implement this, may be the author]
 
 ## Summary
diff --git a/v3/wep/proposals/0001-titlebar-buttons/proposal.md b/v3/wep/proposals/0001-titlebar-buttons/proposal.md
@@ -6,7 +6,7 @@
 **Status**: Implemented  
 **Author**: Lea Anthony  
 **Created**: 2024-05-20  
-**Discussion**: [#3508](https://github.com/wailsapp/wails/pull/3508)  
+**Proposal**: [#3508](https://github.com/wailsapp/wails/pull/3508)  
 **Implementor**: Lea Anthony
 
 ## Summary
