localhost

sorting the wheat from the chaff

Rust 2020: Discoverability

Here we come with the "Request for Comment" about Rust for the next 2020 year. I'm sure 2020 will be a great year, also because it's easy and fast to write :) My wishlist will be short and to the point.

Looking back to what I wished for 2019 I'd like first to see what has changed, from my point of view:

  • We now (almost) have async/await
  • I didn't see significant steps towards building a common ground, a "foundation" for Rust to manage community funding and developing initiatives. We can do better on this, in my opinion.
  • We have a couple of "big names" showing official interest in the Rust language. This is great and will lead to interesting developments and could help spinning the wheel faster. But it will also complicate things. Big names want to be assured that the Rust backbone is strong and firmly managed. Are we ready for this?
  • I have landed in 2019 my first Rust job, it's a great achievement for me and for the community (like I wrote: "every developer that is being paid to do Rust development is a win for the ecosystem.") and I am extremely grateful to the people mentoring and helping me in this journey.

So, what would be my wishlist for 2020?

I can only reiterate how important these points are:

  • Release crates with decent documentation and examples: if you want people to enjoy using your crate, discoverability is at least equally important as the code itself. The README file is the frontline of your crate. Make it shine, make it clear, have people understand at a glance what it's about. Don't give for granted that everyone knows what you know. There's no reason to be dismissive towards your audience; be humble and upfront on what the crate does, its current status and your plans. If it's an experiment, be upfront about that.

    Would you buy a book with no table of contents or a brief summary on the story on the cover?

  • Don't like a crate? Open a PR. Open an issue. Add or improve documentation. Add or improve the examples. If every crate user contributed a small documentation/example PR, the whole Rust ecosystem would be so much better and discoverable than it is now.

There are many people working hard to give us some wonderful tooling, many of them working in the shadow because they have not a "stage-persona" on social media. Do something for them, acknowledge their work, help and improve where you can. Do we want a really inclusive community? Lets' don't forget about them and acknowledge their work. Even a simple "thank you" is important.

I read this list again and I see that a single point still stands: the Rust language and its ecosystem are already so rich that I wouldn't know what else to ask besides being a bit more polished and stable. Therefore I turn the question to: ask yourself what you can do for the Rust community and its ecosystem, rather what Rust can do for you.

Because asking is nice, but asking after you've concretely done something is even better.


Comments closed for this article