"Teach Rust" is free workshop material to use to give a course introducing the Rust programming language. The time for the full course is around three to four days.
The material is created with people with zero Rust experience but with a programming background in mind.
The Spanish translation is community-maintained, we gladly refer to trainers.
The course consists of two parts:
The course presentations is used as an introduction into all basic aspects of Rust. It comes in small parts and ships with integration into the Rust playground for examples as well with a translation structure.
The work examples. The course constructs a small TCP server from ground up.
Along with that, all communication material we used is supplied here.
The presentation material is split into many small to medium presentations for every aspect of Rust. Not all are meant to fully cover a topic, but as an introduction of the important points. Chapters covering basic things such as ownership and borrowing should be exhaustive
The presentations are Reveal presentations with plugins for internationalisation and integration into the Rust Playground.
The path through the presentations is not fixed, to allow leeway during holding the course. Examples of the pathes we used can be found in the courses directory. We recommend to create your own while preparing for giving the workshop.
Currently, the course ships with three examples:
- A simple TCP server that provides a very simple PUT and GET interface to store and remove messages
- The same built with Tokio and Futures
- A Rust library that can be used as a dynamic language
The TCP server is meant to be built from ground up, starting with a fresh crate.
The examples given here are an example of the final state. Before giving this course, you should develop this example by yourself.
There are various tasks which can be found in
src/bin/ and can be run with
cargo run --bin $TASK".
The tasks are as follows:
add-chapter $CHAPTER- Creates a chapter by the name of
$CHAPTERfor each locale.
add-code-example $CHAPTER $INDEX- Appropriately renames all existing code examples (<=
$INDEXare incremented by 1) for
$CHAPTERto make room for a new code example. Also updates the slides to reflect this.
build-indices- Builds the indices in
htmlfor use in a web browser.
extract-code- Extracts code samples from the slides in all chapters and creates appropriate copies in the
presentation/chapters/shared/code/*/*, then updates the slides with new elements reflecting the new location, should not need to be regularly used.
rename-chapter $OLD $NEW- Renames chapter
$NEWfor all locales.
rename-chapters- Renames chapters with an
chapter. Should not need to be regularly used.
Currently, the largest issues are:
- the examples and the presentation lack READMEs
They are open sourced as a contribution to the growth of the Rust language.
If you want to fund further development of the course, book a training!
This course is expressively intended for commercial and free use.
Want to be on this list: open an issue and we will add you.