add documentation on how to keep database up-to-date