❓ How to vision

How you can help

WhenWhat
✅ Now till 2021-04-30Improve the sample projects
✅ Now till 2021-04-30Propose new "status quo" stories or comment on existing PRs
✅ Now till 2021-04-30Propose new "shiny future" stories or comment on existing PRs
🛑 Starting 2021-04-30Vote for the awards on the status quo and shiny future stories!

The big picture

The process we are using to write the vision doc encourages active collaboration and "positive sum" thinking. It starts with a brainstorming period, during which we aim to collect as many "status quo" and "shiny future" stories as we can.

This brainstorming period runs for six weeks, until the end of April. For the first two weeks (until 2021-04-02), we are collecting "status quo" stories only. After that, we will accept both "status quo" and "shiny future" stories until the end of the brainstorming period. Finally, to cap off the brainstorming period, we will select winners for awards like "Most Humorous Story" or "Most Supportive Contributor".

Once the brainstorming period is complete, the working group leads will begin work on assembling the various stories and shiny futures into a coherent draft. This draft will be reviewed by the community and the Rust teams and adjusted based on feedback.

Brainstorming

The brainstorming period runs until 2021-04-30:

The more the merrier!

During this brainstorming period, we want to focus on getting as many ideas as we can. Having multiple "shiny futures" that address the same problem is a feature, not a bug, as it will let us mix-and-match later to try and find the best overall plan. Comments and questions will be used as a tool for improving understanding or sharpening proposals. Presenting alternative ideas is done by writing an alternative story.

Reviewing contributions

To merge a story or project PR, any member of the working group can open a topic on Zulip and propose it be merged. Ideally there will be no outstanding concerns. If a second member of the working group approves, the PR can then be merged.

Reviewers should ensure that new stories and projects are added to the SUMMARY.md file either before merging or directly afterwards.

Harmonizing

At this point, the wg leads will write the draft vision document, drawing on the status quo and shiny future stories that were submitted. Like an RFC, this draft vision doc will be opened for comment and improved based on the resulting feedback. When the wg leads feel it is ready, it will be taken to the lang and libs teams for approval (and other Rust teams as appropriate).

Living document

This meant to be a living document. We plan to revisit it regularly to track our progress and update it based on what we've learned in the meantime. Note that the shiny future stories in particular are going to involve a fair bit of uncertainty, so we expect them to change as we go.

Wait, did somebody say awards?

Yes! We are planning to give awards in various categories for folks who write status quo and shiny future PRs. The precise categories are TBD. Check out the awards page for more details.