ADD CLEAR METHODS DESCRIPTION

[Edmartt]

The methods comments are not clear, we have to guess or search over the internet about how to update or do anything, maybe a big review at the docs is needed

i.e this is not a good description, it says nothing about what it does or how can be used allow us to update, to read, to write?