From 60714e2ad0f6fec528b56c581b39f7a4a0be2c21 Mon Sep 17 00:00:00 2001
From: Michele Cereda <cereda.michele@gmail.com>
Date: Thu, 25 Dec 2025 22:10:00 +0100
Subject: [PATCH] chore(kb/flatpak): revise article

---
 .vscode/settings.json     |  1 +
 knowledge base/flatpak.md | 56 ++++++++++++++++++++++++---------------
 2 files changed, 35 insertions(+), 22 deletions(-)

diff --git a/.vscode/settings.json b/.vscode/settings.json
index 12b071b..ea8adb9 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -161,6 +161,7 @@
         "filebeat",
         "fileglob",
         "firewalld",
+        "flathub",
         "flatpak",
         "fluentd",
         "foris",
diff --git a/knowledge base/flatpak.md b/knowledge base/flatpak.md
index 37d2c43..e3404c9 100644
--- a/knowledge base/flatpak.md	
+++ b/knowledge base/flatpak.md	
@@ -2,6 +2,18 @@
 
 ## TL;DR
 
+<details>
+  <summary>Setup</summary>
+
+```sh
+apt install 'flatpak'
+```
+
+</details>
+
+<details>
+  <summary>Usage</summary>
+
 ```sh
 # List installed applications and runtimes.
 flatpak list
@@ -9,62 +21,62 @@ flatpak list --app
 
 # List remotes.
 flatpak remotes
+flatpak remotes --user
 
 # Add remotes.
-flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
-flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+flatpak remote-add --if-not-exists 'flathub' 'https://flathub.org/repo/flathub.flatpakrepo'
+flatpak remote-add --user --if-not-exists 'flathub' 'https://flathub.org/repo/flathub.flatpakrepo'
 
 # Search for applications.
-flatpak search vscode
+flatpak search 'vscode'
 
 # Install applications.
-flatpak install fedora org.stellarium.Stellarium
-flatpak install --user flathub com.visualstudio.code-oss
-flatpak install https://flathub.org/repo/appstream/org.gimp.GIMP.flatpakref
+flatpak install 'someRemote' 'org.stellarium.Stellarium'
+flatpak install --user 'flathub' 'com.visualstudio.code-oss'
+flatpak install 'https://flathub.org/repo/appstream/org.gimp.GIMP.flatpakref'
 
 # Run applications.
-flatpak run org.gimp.GIMP
+flatpak run 'org.gimp.GIMP'
 
 # Update applications.
 flatpak update
 
 # Uninstall applications.
-flatpak uninstall org.stellarium.Stellarium
+flatpak uninstall 'org.stellarium.Stellarium'
 flatpak uninstall --unused
-flatpak uninstall --delete-data edu.berkeley.BOINC
+flatpak uninstall --delete-data 'edu.berkeley.BOINC'
 
 # Remove remotes.
-flatpak remote-delete flathub
+flatpak remote-delete 'flathub'
 
-# Fix inconsitencies.
+# Fix inconsistencies.
 flatpak repair
 
 # Reset applications' permissions.
-flatpak permission-reset org.gimp.GIMP
+flatpak permission-reset 'org.gimp.GIMP'
 
 # List operations.
 flatpak history
 ```
 
+</details>
+
 ## Further readings
 
-- [Using Flatpak] getting started guide on the official [documentation]
+- [Using Flatpak] getting started guide on the official [documentation].
 
-[documentation]: https://docs.flatpak.org/en/latest/
-[using flatpak]: https://docs.flatpak.org/en/latest/using-flatpak.html
-
-## Sources
-
-All the references in the [further readings] section, plus the following:
+### Sources
 
 - [How to clean up Flatpak apps to clear disk space]
 
 <!--
-  References
+  Reference
+  ═╬═Time══
   -->
 
-<!-- In-article sections -->
-[further readings]: #further-readings
+<!-- Upstream -->
+[documentation]: https://docs.flatpak.org/en/latest/
+[using flatpak]: https://docs.flatpak.org/en/latest/using-flatpak.html
 
 <!-- Others -->
 [how to clean up flatpak apps to clear disk space]: https://www.debugpoint.com/2021/10/clean-up-flatpak/