Merge pull request #120 from Frederik-Baetens/prep_shiny_future

prep for shiny future

Author: nikomatsakis

.github/ISSUE_TEMPLATE/-shiny-vision--story-issue.md

@@ -0,0 +1,31 @@
+---
+name: '"Shiny future" story issue'
+about: Propose a "shiny future" story idea or look for someone to write it
+title: ''
+labels: good first issue, help wanted, shiny-vision-story-ideas
+assignees: ''
+
+---
+
+### Brief summary
+
+*Give a brief summary of the story or vision here*
+
+### Optional details
+
+* (Optional) Which [character(s)] would be the best fit and why?
+    * [ ] [Alan]: the experienced "GC'd language" developer, new to Rust
+    * [ ] [Grace]: the systems programming expert, new to Rust
+    * [ ] [Niklaus]: new programmer from an unconventional background
+    * [ ] [Barbara]: the experienced Rust developer
+* (Optional) Which [project(s)] would be the best fit and why?
+    * *List some projects here.*
+* (Optional) What are the key points or morals to emphasize?
+    * *Write some morals here.*
+
+[character(s)]: https://rust-lang.github.io/wg-async-foundations/vision/characters.html
+[project(s)]: https://rust-lang.github.io/wg-async-foundations/vision/projects.html
+[Alan]: https://rust-lang.github.io/wg-async-foundations/vision/characters/alan.html
+[Grace]: https://rust-lang.github.io/wg-async-foundations/vision/characters/grace.html
+[Niklaus]: https://rust-lang.github.io/wg-async-foundations/vision/characters/niklaus.html
+[Barbara]: https://rust-lang.github.io/wg-async-foundations/vision/characters/barbara.html

src/vision/how_to_vision.md

@@ -6,7 +6,7 @@
 | --- | --- |
 | ✅ **Now** till 2021-04-30 | Improve the [sample projects][hvp] |
 | ✅ **Now** till 2021-04-30 | Propose new ["status quo" stories][hvsq] or [comment] on existing PRs |
-| 🛑 Starting 2021-04-02 | Propose new ["shiny future" stories][hvsf] or [comment] on existing PRs |
+| ✅ **Now** till 2021-04-30 | Propose new ["shiny future" stories][hvsf] or [comment] on existing PRs |
 | 🛑 Starting 2021-04-30 | Vote for the [awards] on the status quo and shiny future stories! |
 
 ## The big picture
@@ -21,7 +21,7 @@ Once the brainstorming period is complete, the working group leads will begin wo
 
 The brainstorming period runs until 2021-04-30:
 
-* Folks open "status quo" and (starting 2021-04-02) "shiny future" story PRs against the [wg-async-foundations repo][repo].
+* Folks open "status quo" and "shiny future" story PRs against the [wg-async-foundations repo][repo].
     * [Templates and instructions for status quo stories can be found here.][hvsq] 
     * You can also browse the [open "status quo" issues] for ideas!
     * [Templates and instructions for shiny future stories can be found here.][hvsf]

src/vision/how_to_vision/shiny_future.md

@@ -1,8 +1,6 @@
 # ❓ How to vision: "Shiny future" stories
 
-## 🛑 Not time for this yet 🛑
-
-We're not ready for this yet! See the [how to vision](../how_to_vision.md) page for details on the phasing.
+We want all Async Rust users and their hopes and dreams for what Async Rust should be in the future to be reflected in the async vision doc, so please help us by writing 'shiny future' stories about what you would like async Rust to look like! **Remember: we are in a brainstorming period.** Please feel free to leave comments in an effort to help someone improve their PRs, but if you would prefer a different approach, you are better off writing your own story. (In fact, you should write your own story even if you like their approach but just have a few alternatives that are worth thinking over.)
 
 [character]: ../characters.md
 [comment]: ./comment.md

src/vision/shiny_future.md

@@ -1,8 +1,10 @@
 # ✨ Shiny future: Where we want to get to
 
-### 🛑 Not time for this yet 🛑
+## 🚧 Under construction! Help needed! 🚧
 
-We're not really ready to work on this section yet. We're still focused on writing out the [status quo](./status_quo.md).
+We are still in the process of drafting the vision document. The stories you see on this page are examples meant to give a feeling for how a shiny future story looks; you can expect them to change. We encourage you to propose your own by opening a PR -- see the ["How to vision"][htv] page for instructions and details.
+
+[htv]: ./how_to_vision.md
 
 ## What it this
 
@@ -18,4 +20,4 @@ We fully expect that the designs and stories described in this document will cha
 
 ## Where are the stories?
 
-We haven't written these yet!
+We haven't written these yet!

src/vision/shiny_future/template.md

@@ -12,9 +12,12 @@
 [`shiny_future`]: https://github.com/rust-lang/wg-async-foundations/tree/master/src/vision/shiny_future
 [`SUMMARY.md`]: https://github.com/rust-lang/wg-async-foundations/blob/master/src/SUMMARY.md
 
-### 🛑 Not time for this yet 🛑
 
-We are not yet accepting shiny future story ideas!
+## 🚧 Warning: Draft status 🚧
+
+This is a draft "shiny future" story submitted as part of the brainstorming period. It is derived from what actual Rust users wish async Rust should be, and is meant to deal with some of the challenges that Async Rust programmers face today.
+
+If you would like to expand on this story, or adjust the answers to the FAQ, feel free to open a PR making edits (but keep in mind that, as peoples needs and desires for async Rust may differ greatly, shiny future stories [cannot be wrong]. At worst they are only useful for a small set of people or their problems might be better solved with alternative solutions). Alternatively, you may wish to [add your own shiny vision story][htvsq]!
 
 ## The story
 
@@ -60,3 +63,5 @@ We are not yet accepting shiny future story ideas!
 [Niklaus]: ../characters/niklaus.md
 [Barbara]: ../characters/barbara.md
 [projects]: ../projects.md
+[htvsq]: ../how_to_vision/shiny_future.md
+[cannot be wrong]: ../how_to_vision/comment.md#comment-to-understand-or-improve-not-to-negate-or-dissuade