diff --git a/core/lib/Drupal/Core/ParamConverter/ParamConverterInterface.php b/core/lib/Drupal/Core/ParamConverter/ParamConverterInterface.php
index 9ca00fa..87436d4 100644
--- a/core/lib/Drupal/Core/ParamConverter/ParamConverterInterface.php
+++ b/core/lib/Drupal/Core/ParamConverter/ParamConverterInterface.php
@@ -19,15 +19,20 @@
  * @code
  * /admin/structure/block/manage/{block}
  * @endcode
- * In this case, 'block' would be the path parameter which should be turned into
- * the block in question for administration.
+ * In this case, '{block}' would be the path parameter which should be turned
+ * into a block object representing the block in question.
+ *
+ * ParamConverters are defined as services tagged with 'paramconverter', and are
+ * managed by the 'paramconverter_manager' service.
  *
  * @see menu
+ * @see \Drupal\Core\ParamConverter\ParamConverterManagerInterface
+ * @see \Drupal\Core\ParamConverter\EntityConverter
  */
 interface ParamConverterInterface {
 
   /**
-   * Convert path variables to their corresponding objects.
+   * Converts path variables to their corresponding objects.
    *
    * @param mixed $value
    *   The raw value.
@@ -44,7 +49,7 @@
   public function convert($value, $definition, $name, array $defaults);
 
   /**
-   * Determine if the converter applies to a specific route and variable.
+   * Determines if the converter applies to a specific route and variable.
    *
    * @param mixed $definition
    *   The parameter definition provided in the route options.