Vision Doc Plan

TL;DR

I'm looking to assemble a small team of people who want to be actively involved in authoring, reviewing, and edited the proposed Rust Vision Doc. I estimate this at ~1-2h per week of work. Reach out to me if interested. I'd like to hold the first sync meeting Jan 30 at 12:00 US Eastern (17:00 UTC) to review and begin discussing Table of Contents.

I'm intrigued, tell me more!

I have proposed a project goal to prepare a rough draft of a Rust vision doc for review at the upcoming All Hands. The vision for the Vision Doc^[1] is to describe the status quo for Rust usage, adoption, and maintenance and make high-level recommendations on what problems we should focus on over the next few years.

The point of this post is to seek out people who may want to help in editing the document. I'll describe a bit how I imagine this working. If you think you'd like to help, please let me know. If you see issues with the plan, please let me know. Thanks!

The plan in a nutshell

“No plan survives first contact with the enemy”, attributed to Helmuth von Moltke; i.e., expect changes as we gain experience with how best to do things!

Current plan …

• Plan the Table of Contents (TOC) draft and get feedback by mid Feb
  • The TOC will describe the major areas we plan to investigate. We will post it on the Rust blog and collect suggestions for other areas worthy of investigation.
• Create stakeholders conversation template and guidelines
• Arrange calls with stakeholders, open calls seeking input on various areas
  • Collect notes from those calls into a gitub repo
• Begin authoring and reviewing drafts
  • We will have a short sync call to decide on what to author and what to review each week

Initial sync meeting proposal:

• Tuesday Jan 30 at 12:00 US Eastern Time (17:00 UTC)

We'll assemble a standing slot after that.

Team roles

Lead: nikomatsakis. I've come to believe that nothing good happens without an owner. I plan to lead this effort. I don't plan to be a dictator, I am always interested in hearing conflicting takes, but I do plan to retain final decision making power and keep us moving along.

Member. Team members will do some combination of the following…

• Interviewing people and taking notes
• Authoring and reviewing drafts of chapters and sections
• Clerical tasks

Expected time:

• Attend standup meeting (15-30min)
• Devote 1-2h per week for authoring, reviewing, or other tasks

Consultant. If the above sounds like more work than you're willing to do, but you're interested in helping review draft TOC or have specific things you'd like to discuss, you may be a good consultant, just reach out and let's talk.

---

1. See what I did there? ↩︎