add a script to update the values
adds some documentation