Dev Guide for Cluster Sharding/Migration

[vazois]

Developer guide webpage containing information about sharding and migration.

[PaulusParssinen]

👍 Great to have more docs! It's gonna be tought to keep the quoted code snippets in sync though?

[lmaas]

The content of the new documentation looks good to me.

I made some small suggestions below. I think we should run a spell-checker on the files before we check them in.

[lmaas]

Adding a few more suggestions below. I think it'd be good to make sure the markdown files render correctly before checking in any changes (there were quite a few mismatched markdown tags).

[vazois]

👍 Great to have more docs! It's gonna be tought to keep the quoted code snippets in sync though?

Good point. I would argue that some fundamental parts of the code base will not change as frequently as others. That being said, we can probably add some pseudocode where needed instead of actual code. We might need to go through the other sections of the dev guide to make sure this convention is followed.

[vazois]

I updated the website to add a reference to github permalink. This way the dev guide is more resilient to code changes.