Relatively big documentation update.

Everything in README.md is now also included in lib.rs as doc comments. lib.rs also contains documentation comments with examples for how to set up `fern`.