a half done documentation of basic gem usage updates