[gedit] flatpak: update/improve some comments

[Sébastien Wilmet <swilmet src gnome org>]

commit ebd5fa06a51278cf353b7fda0ee8cc3ed7364229
Author: Sébastien Wilmet <swilmet informatique-libre be>
Date:   Mon Aug 1 20:58:47 2022 +0200

    flatpak: update/improve some comments

 build-aux/flatpak/generate-json-manifest.sh | 3 +++
 build-aux/flatpak/org.gnome.gedit.yml       | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)
---
diff --git a/build-aux/flatpak/generate-json-manifest.sh b/build-aux/flatpak/generate-json-manifest.sh
index e12e9e3a6..c8544e3e8 100755
--- a/build-aux/flatpak/generate-json-manifest.sh
+++ b/build-aux/flatpak/generate-json-manifest.sh
@@ -5,4 +5,7 @@
 # yq: A portable command-line YAML processor.
 # Currently hosted here: https://github.com/mikefarah/yq
 
+# At the time of writing, some tools around Flatpak (for example gnome-builder)
+# only supports the *.json format, but *.yml is easier to edit.
+
 yq eval 'org.gnome.gedit.yml' --output-format json > 'org.gnome.gedit.json'
diff --git a/build-aux/flatpak/org.gnome.gedit.yml b/build-aux/flatpak/org.gnome.gedit.yml
index 6753b63f2..2bf564b45 100644
--- a/build-aux/flatpak/org.gnome.gedit.yml
+++ b/build-aux/flatpak/org.gnome.gedit.yml
@@ -1,5 +1,5 @@
-# After editing this file run generate-manifest.sh to generate the file
-# org.gnome.gedit.json from this file. Don't edit that other file by hand.
+# After editing this file run generate-json-manifest.sh.
+# Don't edit the *.json manifest file by hand.
 ---
 app-id: org.gnome.gedit
 runtime: org.gnome.Platform