@@ -1,40 +1,24 @@
11Flathub
22-------
33
4−Flathub is the central place for building and hosting flatpak builds.
4+Flathub is the central place for building and hosting Flatpak builds.
55Go to http://flathub.org/builds/#/ to see Flathub in action.
66
77Building applications
88---------------------
99
10−Application manifests should go in their own branches, named after the application ID.
10+Application manifests should go in their own repository in the [Flathub](http://github.com/flathub) organization,
11+named after the application ID.
1112
12−For example, for gnome-recipes, there is a branch named org.gnome.Recipes which has
13−the org.gnome.Recipes.json file at the toplevel.
13+For example, for gnome-recipes, there is a repository named org.gnome.Recipes which has the org.gnome.Recipes.json
14+file at the toplevel.
1415
15−The manifests should build releases, not development snapshots, so please use
16−tarballs or git tags, not just the tip of a branch.
16+Hosted builds should be stable releases, not development snapshots, so please use tarballs or git tags, not just
17+the tip of a branch.
1718
18−In case you build from a git tag, please specify both the tag name and the commit id, like so:
19−```
20− "branch": "1.0.4",
21− "commit": "cdfb19b90587bc0c44404fae30c139f9ec1cca5c"
22−```
23−This makes the build repeatable, since a tag can otherwise change its value over time.
24−You can also use only a commit, but specifying a tag name if there is one is good for readability.
25−
26−Flathub always builds in the flatpak branchname "stable", and it always passes --default-name=stable,
27−so you don't need to specify a branch key. But if you do (not recommended), it must be "stable".
28−
29−Flathub requires that you build against an sdk that is itself hosted on Flathub. The same goes for
30−sdk extensions that may be required to build your application. The easiest way to see what runtimes
31−are currently available is to install the flathub remote and use
32−```
33−flatpak remote-ls --runtime flathub
34−```
35−All applications in flathub should ship with appstream data.
19+More detailed requirements can be found in the [Review Guidelines](https://github.com/flatpak/flathub/wiki/Review-Guidelines)
3620
37−Using the flathub repository
21+Using the Flathub repository
3822----------------------------
3923
4024To install applications that are hosted on Flathub, use the following: