overloading methods with words
repairing docs and fixing issue 3