Add documentation for title hierarchies

Just found this, in the process of adding titles to crates.io repo (https://github.com/rust-lang/crates.io/pull/89). Very useful mixin, but it looks like it's actually doing quite a bit that isn't really documented! This helps toward fixing that.