diff --git a/pkgs/desktops/kde-5/applications-16.04/default.nix b/pkgs/desktops/kde-5/applications-16.04/default.nix
index 5c01c12d9029..bb011f091d1a 100644
--- a/pkgs/desktops/kde-5/applications-16.04/default.nix
+++ b/pkgs/desktops/kde-5/applications-16.04/default.nix
@@ -5,9 +5,9 @@
 Before a major version update, make a copy of this directory. (We like to
 keep the old version around for a short time after major updates.)
 
-1. Update the URL in <nixpkgs/maintainers/scripts/generate-kde-applications.sh>.
+1. Update the URL in `maintainers/scripts/generate-kde-applications.sh`.
 2. From the top of the Nixpkgs tree, run
-   `./maintainers/scripts/generate-kde-applications.sh > pkgs/desktops/kde-5/applications-$VERSION/srcs.nix'.
+   `./maintainers/scripts/generate-kde-applications.sh > pkgs/desktops/kde-5/applications-$VERSION/srcs.nix`.
 3. Check that the new packages build correctly.
 4. Commit the changes and open a pull request.
 
diff --git a/pkgs/desktops/kde-5/frameworks-5.22/default.nix b/pkgs/desktops/kde-5/frameworks-5.22/default.nix
index 362e31c5a256..4d0567846f84 100644
--- a/pkgs/desktops/kde-5/frameworks-5.22/default.nix
+++ b/pkgs/desktops/kde-5/frameworks-5.22/default.nix
@@ -5,7 +5,7 @@
 Before a major version update, make a copy of this directory. (We like to
 keep the old version around for a short time after major updates.)
 
-1. Update the URL in <nixpkgs/maintainers/scripts/generate-kde-frameworks.sh>.
+1. Update the URL in `maintainers/scripts/generate-kde-frameworks.sh`.
 2. From the top of the Nixpkgs tree, run
    `./maintainers/scripts/generate-kde-frameworks.sh > pkgs/desktops/kde-5/frameworks-$VERSION/srcs.nix'.
 3. Check that the new packages build correctly.
diff --git a/pkgs/desktops/kde-5/plasma-5.6/default.nix b/pkgs/desktops/kde-5/plasma-5.6/default.nix
index 16ee9c4b1294..d356dd4bd2fc 100644
--- a/pkgs/desktops/kde-5/plasma-5.6/default.nix
+++ b/pkgs/desktops/kde-5/plasma-5.6/default.nix
@@ -5,7 +5,7 @@
 Before a major version update, make a copy of this directory. (We like to
 keep the old version around for a short time after major updates.)
 
-1. Update the URL in <nixpkgs/maintainers/scripts/generate-kde-plasma.sh>.
+1. Update the URL in `maintainers/scripts/generate-kde-plasma.sh`.
 2. From the top of the Nixpkgs tree, run
    `./maintainers/scripts/generate-kde-plasma.sh > pkgs/desktops/kde-5/plasma-$VERSION/srcs.nix'.
 3. Check that the new packages build correctly.
diff --git a/pkgs/development/libraries/qt-5/5.6/default.nix b/pkgs/development/libraries/qt-5/5.6/default.nix
index d426293ee68c..b5255b4bce1d 100644
--- a/pkgs/development/libraries/qt-5/5.6/default.nix
+++ b/pkgs/development/libraries/qt-5/5.6/default.nix
@@ -4,11 +4,11 @@
 
 Before a major version update, make a copy of this directory. (We like to
 keep the old version around for a short time after major updates.) Add a
-top-level attribute to <nixpkgs/top-level/all-packages.nix>.
+top-level attribute to `top-level/all-packages.nix`.
 
-1. Update the URL in <nixpkgs/maintainers/scripts/generate-qt.sh>.
+1. Update the URL in `maintainers/scripts/generate-qt.sh`.
 2. From the top of the Nixpkgs tree, run
-   `./maintainers/scripts/generate-qt.sh > pkgs/development/libraries/qt-5/$VERSION/srcs.nix'.
+   `./maintainers/scripts/generate-qt.sh > pkgs/development/libraries/qt-5/$VERSION/srcs.nix`.
 3. Check that the new packages build correctly.
 4. Commit the changes and open a pull request.