just a general observation - I wonder if we should try to provide some basic JavaDoc for all methods that we touch aka update or create.