Document Rc<T>

Agreed the convention is noisy. I would be cool if the asserts could be "injected" when making sure the docs are right or something. Maybe like

```
/// five.partial_cmp(4); // Some(Greater)
/// *five;               // 5
```

Being translated to the appropriate asserts?