The definitions format is now specified in spec.git.
To propose changes to the format, please follow the contributing guide, and submit the changes as patches against spec.git project. For major changes, make sure the baserock-dev list is notified, as not everybody reads Gerrit.