1 files changed, 3 insertions, 0 deletions
diff --git a/lib/uri/common.rb b/lib/uri/common.rb
index 006b271477..6378541cbe 100644
--- a/lib/uri/common.rb
+++ b/lib/uri/common.rb
@@ -219,6 +219,9 @@ module URI
   #   p uri.host
   #   # => "www.ruby-lang.org"
   #
+  # It's recommended to first ::escape the provided +uri_str+ if there are any
+  # invalid URI characters.
+  #
   def self.parse(uri)
     RFC3986_PARSER.parse(uri)
   end