diff --git a/core/modules/system/core.api.php b/core/modules/system/core.api.php
index ae61705..131f99f 100644
--- a/core/modules/system/core.api.php
+++ b/core/modules/system/core.api.php
@@ -254,7 +254,7 @@
  *
  * Configuration can be internationalized; see the
  * @link i18n Internationalization topic @endlink for more information. Data
- * types label, text, and data_format in configuration schema are translatable;
+ * types label, text, and date_format in configuration schema are translatable;
  * string is non-translatable text (the 'translatable' property on a schema
  * data type definition indicates that it is translatable).
  *
diff --git a/core/modules/system/language.api.php b/core/modules/system/language.api.php
index 33aaa4c..107512a 100644
--- a/core/modules/system/language.api.php
+++ b/core/modules/system/language.api.php
@@ -85,8 +85,8 @@
  *
  * @section context Translation string sharing and context
  * By default, translated strings are only translated once, no matter where
- * they are being used. For instance, many modules provide forms with Submit
- * buttons on them, and they all would have t('Submit') in their code. The
+ * they are being used. For instance, there are many forms with Save
+ * buttons on them, and they all would have t('Save') in their code. The
  * translation system will only store this string once in the translation
  * database, so that if the translation is updated, all forms using that text
  * will get the updated translation.
@@ -129,7 +129,9 @@
  *     _title: 'May'
  *     _title_context: 'Long month name'
  *
- * // Config schema
+ * // Config schema to say that a certain piece of configuration should be
+ * // translatable using the Config Translation API. Note that the schema label
+ * // is also translatable, but it cannot have context.
  * date_format:
  *  type: string
  *  label: 'PHP date format'