fleshed out in-line documentation