@@ -7,3 +7,16 @@ the org.gnome.Recipes.json file at the toplevel.
77
88The manifests should build releases, not development snapshots, so please use
99tarballs or git tags, not just the tip of a branch.
10+
11+In case you build from a git tag, please specify both the tag name and the commit id, liks so:
12+```
13+ "branch": "1.0.4",
14+ "commit": "cdfb19b90587bc0c44404fae30c139f9ec1cca5c"
15+```
16+This makes the build repeatable, since a tag can otherwise change its value over time.
17+You can also use only a commit, but specifing a tag name if there is one is good for readability.
18+
19+Flathub always builds in the flatpak branchname "stable", and it always passes --default-name=stable,
20+so you don't need to specify a branch key. But if you do (not recommended), it must be "stable".
21+
22+All applications in flathub should ship with appstream data.