document config file spec so far