method has to be public (used in controllers)
client side documentation (part) and overall improvements
client side documentation (part) and overall improvements - cont'd