added info about yaml metadata file
added link to example metadata
default value for published key