diff --git a/components/yaml/introduction.rst b/components/yaml/introduction.rst
index 37bbf6eaeec..17bf495bd83 100644
--- a/components/yaml/introduction.rst
+++ b/components/yaml/introduction.rst
@@ -120,20 +120,29 @@ error occurred:
     As the parser is re-entrant, you can use the same parser object to load
     different YAML strings.
 
-When loading a YAML file, it is sometimes better to use the
+It may also be convenient to use the
 :method:`Symfony\\Component\\Yaml\\Yaml::parse` wrapper method:
 
 .. code-block:: php
 
     use Symfony\Component\Yaml\Yaml;
 
-    $yaml = Yaml::parse('/path/to/file.yml');
+    $yaml = Yaml::parse(file_get_contents('/path/to/file.yml'));
 
 The :method:`Symfony\\Component\\Yaml\\Yaml::parse` static method takes a YAML
 string or a file containing YAML. Internally, it calls the
 :method:`Symfony\\Component\\Yaml\\Parser::parse` method, but enhances the
 error if something goes wrong by adding the filename to the message.
 
+.. note::
+
+    Although it is currently possible to pass the
+    :method:`Symfony\\Component\\Yaml\\Yaml::parse` static method a
+    filename, this functionality is deprecated in Symfony 2.3, and will be
+    removed in Symfony 3.0. Because it is possible to pass a filename, if
+    you use this method, you must validate the input first.
+
+
 Writing YAML Files
 ~~~~~~~~~~~~~~~~~~