Add section about task_local and lock_free
@@ -136,3 +136,15 @@ any kind of lock.
$ cargo run --example only-shared-access
{{#include ../../../../ci/expected/only-shared-access.run}}
```
+
+## Lock-free resource access of mutable resources
+
+There exists two other options dealing with resources
+
+* `#[lock_free]`: there might be several tasks with the same priority
+ accessing the resource without critical section. Since tasks with the
+ same priority never can preempt another task on the same priority
+ this is safe.
+* `#[task_local]`: there must be only one task using this resource,
+ similar to a task local resource, but (optionally) set-up by init.
+
