+1, in fact a detailed description of the update strategy and how the function determines if the DB is an old version should be placed in the docstring.