The great docs update

1 files changed, 14 insertions, 0 deletions

diff --git a/book/en/src/by-example/message_passing.md b/book/en/src/by-example/message_passing.md
new file mode 100644
index 0000000..b80ae03
--- /dev/null
+++ b/book/en/src/by-example/message_passing.md
@@ -0,0 +1,14 @@
+# Message passing & capacity
+
+Software tasks have support for message passing, this means that they can be spawned with an argument
+as `foo::spawn(1)` which will run the task `foo` with the argument `1`. The number of arguments is not
+limited and is exemplified in the following:
+
+``` rust
+{{#include ../../../../examples/message_passing.rs}}
+```
+
+``` console
+$ cargo run --target thumbv7m-none-eabi --example message_passing
+{{#include ../../../../ci/expected/message_passing.run}}
+```