theforeman · maximiliankolb · Jul 9, 2026 · Jul 6, 2026 · Jul 6, 2026 · Jul 6, 2026
diff --git a/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc b/guides/common/modules/con_managing-flatpak-repositories-in-project.adoc
@@ -4,8 +4,7 @@
 = Managing Flatpak repositories in {Project}
 
 [role="_abstract"]
-Flatpak allows users to install, manage, and run portable applications, primarily for desktop environments.
-In {Project}, you can integrate Flatpak remotes and synchronize Flatpak repositories into products to manage application content centrally.
+Flatpak remotes in {Project} connect to external application indexes so you can scan available repositories, mirror them into products, and distribute desktop application content to hosts.
 
 Flatpak repositories function similarly to other content repositories in {Project}.
 You can synchronize, manage access permissions, and assign repositories to specific lifecycle environments to control which applications are available to hosts.

diff --git a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-cli.adoc
@@ -4,7 +4,7 @@
 = Creating a Flatpak remote by using Hammer CLI
 
 [role="_abstract"]
-You can create a Flatpak remote to access and manage Flatpak repositories by using Hammer CLI.
+Add a Flatpak remote to your {Project} inventory to scan it, mirror selected repositories into your products, and distribute desktop application content to hosts.
 
 .Prerequisites
 * Your {Project} account has a role that grants the `create_flatpak_remotes` permission.

diff --git a/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc b/guides/common/modules/proc_creating-a-flatpak-remote-by-using-web-ui.adoc
@@ -4,7 +4,7 @@
 = Creating a Flatpak remote by using {ProjectWebUI}
 
 [role="_abstract"]
-You can create a Flatpak remote to access and manage Flatpak repositories in {ProjectWebUI}.
+Add a Flatpak remote to your {Project} inventory to scan it, mirror selected repositories into your products, and distribute desktop application content to hosts.
 
 .Prerequisites
 * Your {Project} account has a role that grants the `create_flatpak_remotes` permission.

diff --git a/...roc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc b/...roc_mirroring-remote-flatpak-repositories-to-project-products-by-using-cli.adoc
@@ -4,7 +4,7 @@
 = Mirroring remote Flatpak repositories to {Project} products by using Hammer CLI
 
 [role="_abstract"]
-You can mirror a Flatpak repository from a Flatpak remote into an existing product in {Project} to make it available for content management and distribution.
+Mirror a Flatpak repository from a scanned remote into an existing product so you can synchronize it and publish application content to hosts through content views.
 
 This action creates a new repository inside the product you selected.
 You can now synchronize the repository to pull down its content.
@@ -16,12 +16,13 @@ To make the {EL} 10 Mozilla Firefox Flatpak available to a host, ensure that the
 endif::[]
 
 .Prerequisites
+* The Flatpak remote has been scanned.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions.
-* Ensure that Flatpak runtime repositories are available to hosts alongside application repositories.
+* You have created a {customproduct} on {Project}.
+* Flatpak runtime repositories are available to hosts alongside application repositories.
 ifdef::katello,satellite,almalinux,oracle_linux,red_hat_enterprise_linux,rocky_linux[]
 Flatpak applications, such as `rhel9/firefox-flatpak`, depend on the runtime for installation.
 endif::[]
-* You have created a {customproduct} on {Project}.
 
 .Procedure
 * Mirror a Flatpak repository into your product:
@@ -33,3 +34,6 @@ $ hammer flatpak-remote remote-repository mirror \
 --id _My_Flatpak_Repository_ID_ \
 --product-id _My_Product_ID_
 ----
+
+.Next steps
+* xref:synchronizing-repositories-ad-hoc[]
diff --git a/..._mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc b/..._mirroring-remote-flatpak-repositories-to-project-products-by-using-web-ui.adoc
@@ -4,7 +4,7 @@
 = Mirroring remote Flatpak repositories to {Project} products by using {ProjectWebUI}
 
 [role="_abstract"]
-You can mirror a Flatpak repository from a Flatpak remote into an existing product in {Project} to make it available for content management and distribution.
+Mirror a Flatpak repository from a scanned remote into an existing product so you can synchronize it and publish application content to hosts through content views.
 
 This action creates a new repository inside the product you selected.
 You can now synchronize the repository to pull down its content.
@@ -16,12 +16,13 @@ To make the {EL} 10 Mozilla Firefox Flatpak available to a host, ensure that the
 endif::[]
 
 .Prerequisites
+* The Flatpak remote has been scanned.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions.
-* Ensure that Flatpak runtime repositories are available to hosts alongside application repositories.
+* You have created a {customproduct} on {Project}.
+* Flatpak runtime repositories are available to hosts alongside application repositories.
 ifdef::katello,satellite,almalinux,oracle_linux,red_hat_enterprise_linux,rocky_linux[]
 Flatpak applications, such as `rhel9/firefox-flatpak`, depend on the runtime for installation.
 endif::[]
-* You have created a {customproduct} on {Project}.
 
 .Procedure
 . In the {ProjectWebUI}, navigate to *Content* > *Flatpak Remotes*.
@@ -30,3 +31,6 @@ endif::[]
 . Select the *Mirror Action* menu on the row of the repository.
 . In the *Mirror* window, select the existing product where you want to create the new repository.
 . Click *Mirror*.
+
+.Next steps
+* xref:synchronizing-repositories-ad-hoc[]
diff --git a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-cli.adoc
@@ -4,11 +4,11 @@
 = Scanning a Flatpak remote by using Hammer CLI
 
 [role="_abstract"]
-You can scan a Flatpak remote to fetch metadata about the repositories it provides.
-Scanning a Flatpak remote creates remote repository artifacts for the repositories hosted by the Flatpak remote.
-If new repositories are added to the Flatpak remote, scan it again to pull in the changes.
+Scan a Flatpak remote to discover the repositories its index hosts before you mirror them into products.
+Rescan the remote when new repositories are added.
 
 .Prerequisites
+* A Flatpak remote exists in {Project}.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions.
 
 .Procedure

diff --git a/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc b/guides/common/modules/proc_scanning-a-flatpak-remote-by-using-web-ui.adoc
@@ -4,11 +4,11 @@
 = Scanning a Flatpak remote by using {ProjectWebUI}
 
 [role="_abstract"]
-You can scan a Flatpak remote to fetch metadata about the repositories it provides.
-Scanning a Flatpak remote creates remote repository artifacts for the repositories hosted by the Flatpak remote.
-If new repositories are added to the Flatpak remote, scan it again to pull in the changes.
+Scan a Flatpak remote to discover the repositories its index hosts before you mirror them into products.
+Rescan the remote when new repositories are added.
 
 .Prerequisites
+* A Flatpak remote exists in {Project}.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` and `edit_flatpak_remotes` permissions.
 
 .Procedure

diff --git a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-cli.adoc
@@ -4,9 +4,10 @@
 = Viewing Flatpak remote details by using Hammer CLI
 
 [role="_abstract"]
-You can view a list of the repositories a scanned Flatpak remote provides.
+Review the repositories a scanned Flatpak remote provides to decide which ones to mirror into your products.
 
 .Prerequisites
+* The Flatpak remote has been scanned.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` permission.
 
 .Procedure

diff --git a/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc b/guides/common/modules/proc_viewing-flatpak-remote-details-by-using-web-ui.adoc
@@ -4,9 +4,10 @@
 = Viewing Flatpak remote details by using {ProjectWebUI}
 
 [role="_abstract"]
-You can view a list of the repositories a scanned Flatpak remote provides.
+Review the repositories a scanned Flatpak remote provides to decide which ones to mirror into your products.
 
 .Prerequisites
+* The Flatpak remote has been scanned.
 * Your {Project} account has a role that grants the `view_flatpak_remotes` permission.
 
 .Procedure