add documentation for the gem

Is this pretty clear?