diff -u b/core/modules/media/src/OEmbed/Resource.php b/core/modules/media/src/OEmbed/Resource.php
--- b/core/modules/media/src/OEmbed/Resource.php
+++ b/core/modules/media/src/OEmbed/Resource.php
@@ -10,7 +10,7 @@
  * Mutable value object representing an oEmbed resource.
  *
  * Data received from an oEmbed provider could be insecure. For example,
- * resources of the 'rich' type provide an HTML representation, and it is not
+ * resources of the 'rich' type provide an HTML representation which is not
  * sanitized by this object in any way. Any values you retrieve from this object
  * should be treated as potentially dangerous user input and carefully validated
  * and sanitized before being displayed or otherwise manipulated by your code.
diff -u b/core/modules/media/src/OEmbed/ResourceFetcher.php b/core/modules/media/src/OEmbed/ResourceFetcher.php
--- b/core/modules/media/src/OEmbed/ResourceFetcher.php
+++ b/core/modules/media/src/OEmbed/ResourceFetcher.php
@@ -96,7 +96,7 @@
    * @return \Drupal\media\OEmbed\Resource
    *   A value object representing the resource.
    *
-   * @throws \Drupal\media\OEmbed\ResourceException
+   * @throws \Drupal\media\OEmbed\RawResourceException
    *   If the resource cannot be created.
    */
   protected function createResource(array $data, $url) {
diff -u b/core/modules/media/src/OEmbed/ResourceFetcherInterface.php b/core/modules/media/src/OEmbed/ResourceFetcherInterface.php
--- b/core/modules/media/src/OEmbed/ResourceFetcherInterface.php
+++ b/core/modules/media/src/OEmbed/ResourceFetcherInterface.php
@@ -3,10 +3,12 @@
 namespace Drupal\media\OEmbed;
 
 /**
- * Interface for ResourceFetcher service.
+ * Defines an interface for an oEmbed resource fetcher service.
  *
- * The resource fetchers only responsibility is to get an oEmbed resource URL
- * and returns the resource object.
+ * The resource fetcher's only responsibility is to retrieve oEmbed resource
+ * data from an endpoint URL (i.e., as returned by
+ * \Drupal\media\OEmbed\UrlResolverInterface::getResourceUrl()) and return a
+ * \Drupal\media\OEmbed\Resource value object.
  */
 interface ResourceFetcherInterface {