diff --git a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
--- a/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
+++ b/documentation/content/en/books/porters-handbook/quick-porting/_index.adoc
@@ -149,6 +149,8 @@
 ====
 It is recommended to keep all the filenames in this file sorted alphabetically.
 It will make verifying changes when upgrading the port much easier.
+The sorting should be applied after variable expansion takes place.
+The framework does this correctly when the package list is crossref:plist[plist-autoplist,generated automatically].
 ====
 
 [TIP]