fix typos in .yaml and clarify settings