diff --git a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
--- a/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/upgrading/_index.adoc
@@ -87,14 +87,13 @@
 
 [source,shell]
 ....
-% cd ~/my_ports_wrkdir <.>
-% git clone https://git.FreeBSD.org/ports.git <.>
+% git clone https://git.FreeBSD.org/ports.git ~/my_wrkdir <.> <.>
 % cd ~/my_wrkdir/dns/pdnsd
 ....
 
 <.> This can be anywhere, of course. Building ports is not limited to within [.filename]#/usr/ports/#.
 
-<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}#svn-mirrors[Subversion mirror sites] for more information.
+<.> https://git.FreeBSD.org/[git.FreeBSD.org] is the FreeBSD public Git server. See link:{handbook}mirrors/#git-url-table[FreeBSD Git Repository URL Table] for more information.
 
 While in the port directory, make any changes that are needed. If adding, moving, or removing a file, use `git` to track these changes: