A library which finds language features in rust code and provides resources on them.

See it in action!

Introducing Rust in existing teams can be difficult. Some members might work primarily in other languages and therefore can't devote much time to learn rust in all its facets. Code in an unfamiliar syntax looks like gibberish at first, whilst the underlying concepts might in fact be similar with a known language.

That's where tooling comes into play: Paste your code / let it run on your source and it'll link to e.g. the rust book page for destructuring patterns for further reading. Ideally, this will make it possible for rust beginners to dive into existing, expressive code bases, while learning rust on the fly.

1. Paste your code
2. Move your cursor to a thing you don't understand.
3. Read the context sensitive explanation
4. Profit

• Context sensitive explanation
  • Syntax
  • Controlflow
  • Lifetimes (Venn Diagram style?)

Please open issues with syntax you'll find hard to grasp. Unless already covered (if in doubt, open issue anyway), these will be integrated into our syntax studies. This will give us a good feeling on where to focus in the beginning.

Eventually, we want to support the rust syntax completely. Things i'd like to explore at that point would be pattern analysis and type level integration via RLS.

Pre alpha. Don't expect it to work on your code.

explain-rs is distributed under the terms of both the MIT license and the Apache License (Version 2.0).