added notes about files and yaml