   @doc """
   Creates a new range.
 
-  If first is less than last, the range will be increasing from
-  first to last. If first is equal to last, the range will contain
+  If `first` is less than `last`, the range will be increasing from
+  `first` to `last`. If `first` is equal to `last`, the range will contain
   one element, which is the number itself.
 
-  If first is more than last, the range will be decreasing from first
-  to last, albeit this behaviour is deprecated. Instead prefer to
-  explicitly list the step `new/3`.
+  If `first` is greater than `last`, the range will be decreasing from `first`
+  to `last`, albeit this behaviour is deprecated. Therefore, it is advised to
+  explicitly list the step with `new/3`.
 
   ## Examples
 

  end

  @doc """
  Returns the size of the range.

  ## Examples



  Ranges are always inclusive and they may have custom steps.
  The most common form of creating and matching on ranges is
  via the [`start..stop`](`../2`) and [`start..stop//step`](`..///3`) notations,
  defined respectively as the `../2` and `..///3` macros
  auto-imported from `Kernel`:

