diff --git a/doc/overlays.xml b/doc/overlays.xml
index c921289fd6c..c20045b217b 100644
--- a/doc/overlays.xml
+++ b/doc/overlays.xml
@@ -40,17 +40,17 @@ first one present is considered, and all the rest are ignored:
-For the second and third option, the directory should contain Nix expressions defining the
+For the second and third options, the directory should contain Nix expressions defining the
overlays. Each overlay can be a file, a directory containing a
default.nix, or a symlink to one of those. The expressions should follow
the syntax described in .
The order of the overlay layers can influence the recipe of packages if multiple layers override
-the same recipe. In the case where overlays are loaded from a directory, these are loaded in
+the same recipe. In the case where overlays are loaded from a directory, they are loaded in
alphabetical order.
To install an overlay using the last option, you can clone the overlay's repository and add
-a symbolic link to in the ~/.nixpkgs/overlays/ directory.
+a symbolic link to it in ~/.nixpkgs/overlays/ directory.
@@ -60,7 +60,7 @@ a symbolic link to in the ~/.nixpkgs/overlays/ directory.
Overlays Layout
Overlays are expressed as Nix functions which accept 2 arguments and return a set of
-packages
+packages.
self: super: