Child of #2323895: [Meta] Document format/content of various YML files (we have been discussing how to document *.yml files).
There is a topic https://api.drupal.org/api/drupal/core!modules!system!core.api.php/group... that talks about modules, themes, and profiles.
It has two problems:
a) The link about Distributions/Profiles goes to a page on drupal.org that is more about what they are than how to develop them. It should be linking to https://www.drupal.org/node/159730 instead.
b) There is no information on api.d.o about the *.info.yml file syntax. So we need to add sections to this topic about this file syntax. The easiest way is probably to give minimal examples of the syntax for a theme, a module, and a profile.
Probably a good Novice project?
Beta eval: This is a Normal Task, but it is documentation-only and not disruptive, and is therefore allowed to be committed during Beta or even after release for that matter.