Extend documentation in README

Add more details in README, including a reminder to update the
tokens files. Also document the start-date parameter.