diff --git a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
--- a/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/makefiles/_index.adoc
@@ -100,8 +100,8 @@
 
 [TIP]
 ====
-When updating a port, it is possible to use man:pkg-version[8]'s `-t` argument to check if the new version is greater or lesser than before.
-See crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions].
+When updating a port, it is possible to use the `-t` argument of man:pkg-version[8] to check if the new version is greater or lesser than before.
+See below on how to use  man:pkg-version[8] to compare versions.
 ====
 
 [[makefile-versions-ex-pkg-version]]
@@ -1576,8 +1576,8 @@
 GH_TAGNAME=	c472d66b
 ....
 
-This creates a versioning scheme that increases over time, and that is still
-before version `0` (see crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions] for details on man:pkg-version[8]):
+This creates a versioning scheme that increases over time, and that is still before version `0`.
+See crossref:makefiles[makefile-versions-ex-pkg-version, this secion on how to compare versions] using  man:pkg-version[8]):
 
 [source,shell]
 ....
@@ -1622,7 +1622,8 @@
 ....
 
 This creates a versioning scheme that increases over time (well, over commits), and does not conflict with the creation of a `0.7.4` version.
-(See crossref:makefiles[makefile-versions-ex-pkg-version, Using man:pkg-version\[8\] to Compare Versions] for details on man:pkg-version[8]):
+
+See crossref:makefiles[makefile-versions-ex-pkg-version, this section for how to compare versions] using  man:pkg-version[8]):
 
 [source,shell]
 ....
diff --git a/documentation/content/en/books/porters-handbook/testing/_index.adoc b/documentation/content/en/books/porters-handbook/testing/_index.adoc
--- a/documentation/content/en/books/porters-handbook/testing/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/testing/_index.adoc
@@ -112,9 +112,8 @@
 
 Since `portlint` uses heuristics to try to figure out errors, it can produce false positive warnings.
 In addition, occasionally something that is flagged as a problem really cannot be done in any other way due to limitations in the ports framework.
-pass:[<!-- vale Vale.Terms = NO -->]
-When in doubt, the best thing to do is ask on {freebsd-ports}.
-pass:[<!-- vale Vale.Terms = YES -->]
+
+When in doubt, the best thing to do is ask on the FreeBSD Ports mailing list: link:https://lists.freebsd.org/subscription/freebsd-ports[freebsd-ports].
 
 [[testing-porttools]]
 == Port Tools
@@ -353,9 +352,9 @@
 ....
 
 updates the specified jail to the latest version available.
-pass:[<!-- vale Vale.Terms = NO -->]
+
 For FreeBSD releases, update to the latest patchlevel with man:freebsd-update[8].
-pass:[<!-- vale Vale.Terms = YES -->]
+
 For FreeBSD versions built from source, update to the latest git revision in the branch.
 
 [TIP]
diff --git a/documentation/content/en/books/porters-handbook/versions/_index.adoc b/documentation/content/en/books/porters-handbook/versions/_index.adoc
--- a/documentation/content/en/books/porters-handbook/versions/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/versions/_index.adoc
@@ -4014,9 +4014,7 @@
 |1001509
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |10-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |1001510
 |link:https://svnweb.freebsd.org/changeset/base/279329[279329]
@@ -4664,9 +4662,7 @@
 |903508
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |9-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |903509
 |link:https://svnweb.freebsd.org/changeset/base/296219[296219]
@@ -5449,9 +5445,7 @@
 |804508
 |link:https://svnweb.freebsd.org/changeset/base/279287[279287]
 |February 25, 2015
-pass:[<!-- vale Vale.Terms = NO -->]
 |8-STABLE after FreeBSD-EN-15:01.vt, FreeBSD-EN-15:02.openssl, FreeBSD-EN-15:03.freebsd-update, FreeBSD-SA-15:04.igmp, and FreeBSD-SA-15:05.bind.
-pass:[<!-- vale Vale.Terms = YES -->]
 
 |804509
 |link:https://svnweb.freebsd.org/changeset/base/305736[305736]