Add documentation on the macro itself

[dcchut]

Adds usage documentation to the attribute macro so it shows up in reexports.

I like having the documentation on the main page (without requiring a click through) so I've placed usage documentation in a file which is then used by both the crate docs and the macro docs.

Fixes #16