flatpak-docs icon indicating copy to clipboard operation
flatpak-docs copied to clipboard

tutorial improvements

Open matthiasclasen opened this issue 6 years ago • 1 comments

In "Building your first Flatpak", I think it would help to separate the last two steps a bit.

  1. Install the app
  2. Run the app

are really not part of the developer workflow, but just the normal user workflow. Imo, it would make sense after step 5 to pause and explain that you can now copy the repository to a web server to make it available to others. And then point out that it is a good idea to test the app from the repo before doing so, thus steps 7 and 8.

matthiasclasen avatar Mar 21 '18 22:03 matthiasclasen

I've replaced the old hello world tutorial with the one that uses GNOME Dictionary as the example. The new wording is a bit different and might resolve your issue. Can you check it and let me know if it's OK?

allanday avatar Mar 22 '18 17:03 allanday

I'd argue that installing and running are part of the developer workflow. From what I've seen after reviewing submissions on Flathub, most people submitting, never test their apps once built. It's good to test once sonething has been built and check if everything is running correctly.

you can now copy the repository to a web server to make it available to others.

Serving it through a repo on a webserver in a way that users can recieve updates, is way too complicated concept to be introduced in a hello world guide imo. There is a whole section dedicated on flatpak repo files, how to gpg sign, how to make a CI workflow etc.

For single time sharing use case the hello world guide now covers sharing bundles.

I've added example workflows on how to serve flatpak repos from gitlab pages which should serve the usecase.

And most people following the guide is going to submit the app to an application store or build something locally.

Closing.

bbhtt avatar Jul 07 '24 05:07 bbhtt