Updated documentation of the changes

[Ellypse]

We should update the documentation and also indicate the changes (basically, maybe keep technical details for documentation) in the readme, as things are settling down. No hurry, I'm just creating the ticket so we don't forget.

It could be interesting also to have in-game documentation with the /api command (like Chomp).