add in-line documentation