update

Author: nikomatsakis

.github/ISSUE_TEMPLATE/experience-report.md

@@ -0,0 +1,20 @@
+---
+name: Experience report
+about: Describe your experiences with GATs
+title: ''
+labels: experience-report
+assignees: ''
+
+---
+
+### Code description
+
+Describe what you were trying to do with generic associated types. Links to source code are always appreciated!
+
+### What worked well
+
+Describe what aspects of GATs worked well for you.
+
+### What worked less well
+
+Describe what aspects of GATs did not work well for you. Perhaps they were confusing, or you weren't able to get your code to compile the way you wanted? Or perhaps it was just not ergonomic.

README.md

@@ -27,22 +27,13 @@
 ![initiative status: active](https://img.shields.io/badge/status-active-brightgreen.svg)
 [![initiative documentation](https://img.shields.io/badge/MDBook-View%20Documentation-blue)][gh-pages]
 
+## What is this?
 
-**FIX ME**
-
-<!--
- Provide a short introduction about your initiative. Make sure to include any
- relevant links to information about your group.
--->
-
-Welcome to the repository for the {{INITIATIVE_NAME}} [initiative]! This is the repository we use to organise our work. Please refer to our [charter] as well as our [github pages website][gh-pages] for more information on our goals and current scope.
+This page tracks the work of the {{INITIATIVE_NAME}} [initiative]! To learn more about what we are trying to do, and to find out the people who are doing it, take a look at the [charter]. 
 
 [charter]: ./CHARTER.md
-[gh-pages]: https://rust-lang.github.io/{{INITIATIVE_SLUG}}
 [initiative]: https://lang-team.rust-lang.org/initiatives.html
 
-**/FIX ME**
-
 ## Current status
 
 The following table lists of the stages of an initiative, along with links to the artifacts that will be produced by the start of that stage.
@@ -71,27 +62,13 @@ Key:
 
 ## How Can I Get Involved?
 
-**FIX ME**
-
-<!--
- List ways that people from outside your group can get involved and potentially
- become members, include what meetings your team has, and how a person could
- start participating and contributing. Make sure to mention the main platform
- your group hosts its discussions. Be sure to also include links to any
- other projects that your group maintains.
--->
-
-The issues from this repository
-
-[You can find a list of the current members available
-on `rust-lang/team`.][team-toml]
-
-If you'd like to participate be sure to check out any of our [open issues] on this
-repository.
-
-We also participate on [{{CHAT_PLATFORM}}][chat-link], feel free to introduce
-yourself over there and ask us any questions you have.
+* If you would like to help with development, please contact the [owner](./charter.md#membership) to find out if there are things that need doing.
+* If you would like to help with the design, check the list of active [design questions](./design-questions/README.md) first. 
+* If you have questions about the design, you can file an issue, but be sure to check the [FAQ](./FAQ.md) or the [design-questions](./design-questions/README.md) first to see if there is already something that covers your topic.
+* If you are using the feature and would like to provide feedback about your experiences, please [open a "experience report" issue].
+* If you are using the feature and would like to report a bug, please open a regular issue.
 
+We also participate on [{{CHAT_PLATFORM}}][chat-link], feel free to introduce yourself over there and ask us any questions you have.
 
 [open issues]: /issues
 [chat-link]: {{CHAT_LINK}}

evaluation.md

@@ -1,6 +1,6 @@
 # 🔬 Evaluation
 
-The *evaluation* surveys the various design approaches that are under consideration.
+> The *evaluation* surveys the various design approaches that are under consideration.
 It is not required for all initiatives, only those that begin with a problem statement
 but without a clear picture of the best solution. Often the evaluation will refer to topics
 in the [design-discussions] for more detailed consideration.