diff --git a/build/jam/repositories/HaikuPorts/README.md b/build/jam/repositories/HaikuPorts/README.md
new file mode 100644
index 0000000000..7238f6c76e
--- /dev/null
+++ b/build/jam/repositories/HaikuPorts/README.md
@@ -0,0 +1,24 @@
+HaikuPorts repository files
+==========================
+
+This directory contains RemotePackageRepository files
+which detail packages and repositories leveraged during
+Haiku's build process.
+
+> Warning: The URL packages are obtained from
+> are determined by the sha256sum of the repository
+> file.
+
+Updating
+-------
+
+Each RemotePackageRepository jam file in this directory
+is processed by src/tools/hardlink_packages.py on the
+HaikuPorts package server.
+
+1) Latest RemotePackageRepository jam file in git is downloaded on package server.
+2) Packages are added to HaikuPorts by automatic or manual means.
+3) hardlink_packages is provided all the relevant directories and RemotePackageRepository file
+4) hardlink_packages performs additional modification of the RemotePackageRepository and creates
+   build repositories (https://eu.hpkg.haiku-os.org/haikuports/master/build-packages/)
+5) The modified RemotePackageRepository file is copied back to the developers system and checked in to git.
diff --git a/build/jam/repositories/HaikuPorts/arm b/build/jam/repositories/HaikuPorts/arm
index 650a602f4c..d906077915 100644
--- a/build/jam/repositories/HaikuPorts/arm
+++ b/build/jam/repositories/HaikuPorts/arm
@@ -1,16 +1,12 @@
-#
-# The remote repository URL depends on the sha256sum of this file.
-#
-
 RemotePackageRepository HaikuPorts
 	: arm
 	: https://eu.hpkg.haiku-os.org/haikuports/master/build-packages/packages
 	:
 	# architecture "any" packages
 	be_book-2008_10_26-1
-	ca_root_certificates-2015_02_25-1
-	timgmsoundfont-2004_01_24-4
-	wqy_microhei-0.2.0~beta-3
+	ca_root_certificates-2017_01_18-1
+	timgmsoundfont-fixed-5
+	wqy_microhei-0.2.0~beta-4
 	:
 	# repository architecture packages
 	# primary architecture (arm)
@@ -28,7 +24,6 @@ RemotePackageRepository HaikuPorts
 	zlib-1.2.8-4
 	zlib_devel-1.2.8-4
 	:
-
 	# source packages
 	apr
 	autoconf