add some documentation to the .make() function