miniblog.

I'm trying to factor out the interior mutability in my Rust code. It's a little more verbose, but surprisingly readable. foo_old(&syntax); foo_new(&syntax, &mut change_map); Signatures are way more self-documenting with this approach.

The challenge with literate programming is separating the important details from glue code. Some code is boring or self-documenting.

Blogged: Rustdoc Meets The Self-Documenting Editor https://www.wilfred.me.uk/blog/2016/08/27/rustdoc-meets-the-self-documenting-editor/ cc @rustlang