Reword port warning in YAML reference, remove it from README
Reformat comments in YAML reference for readability