(master) clarified documentation