add support for the .yml extension

Realized that both `.yaml` and `.yml` are used for YAML files. Refactored a bit to make the extensions really clear and added doc blocks for clarity.

cc @anthonyshort