More README work, and better definitions.

Also converted everything over to yaml.

Yes, I'm stalling.