Write docs for transition to new crate structure

[thomaseizinger]

Created as a result of #272 (review).

This issue is to collect what needs to be done before we can cut the first release:

Tasks

Beta Give feedback

1. Document how users can replace the identity hasher. Done in feat(codetable): remove identity hasher #289.
2. docs: explain multihash-derive and multihash-codetable #320
   +0
3. docs: add migration section #321
   +0
4. docs: make README not terribly outdated #319
   +0

[thomaseizinger]

README needs to be updated too.

[thomaseizinger]

Where do you think would this migration docs best be written? In the README? Normally I'd add it to the changelog but that one is auto-generated here, right?

[vmx]

Normally I'd add it to the changelog but that one is auto-generated here, right?

The changelog. I'd call it "semi-autogenerated". So what I would do is, creating the new entries as outlined in the RELEASE.md and then manually tweak it. Please note that I've tried to make it clearer (and also updated the instructions for the generation) at #314.

[thomaseizinger]

@vmx all items in here now have an open PR. Do you mind having a look and see if that is sufficient documentation so we can cut a release?

[thomaseizinger]

Closing this because all tasks are completed.