diff --git a/lib/elixir/lib/float.ex b/lib/elixir/lib/float.ex
index ced181ba5b8..7ec9bbc391e 100644
--- a/lib/elixir/lib/float.ex
+++ b/lib/elixir/lib/float.ex
@@ -15,7 +15,7 @@ defmodule Float do
   If the size of float exceeds the maximum size of `1.7976931348623157e+308`,
   the `ArgumentError` exception is raised.
 
-  If a float formatted string wants to be directly converted to a float,
+  If you want to convert a string-formatted float directly to a float,
   `String.to_float/1` can be used instead.
 
   ## Examples
diff --git a/lib/elixir/lib/integer.ex b/lib/elixir/lib/integer.ex
index 1d38323d765..3f3b9387522 100644
--- a/lib/elixir/lib/integer.ex
+++ b/lib/elixir/lib/integer.ex
@@ -131,6 +131,9 @@ defmodule Integer do
 
   Raises an error if `base` is less than 2 or more than 36.
 
+  If you want to convert a string-formatted integer directly to a integer,
+  `String.to_integer/1` or `String.to_integer/2` can be used instead.
+
   ## Examples
 
       iex> Integer.parse("34")