diff -u b/core/modules/system/core.api.php b/core/modules/system/core.api.php
--- b/core/modules/system/core.api.php
+++ b/core/modules/system/core.api.php
@@ -1033,7 +1033,8 @@
  * name (or machine name) of the extension, and this directory must contain a
  * file named machine_name.info.yml (where machine_name is the machine name of
  * the extension).
- * @see \Drupal\Core\Extension\InfoParserInterface::parse()
+ * See \Drupal\Core\Extension\InfoParserInterface::parse() for documentation of
+ * the format of .info.yml files.
  * @}
  */