docs updated
method definitions updated