<div dir="ltr"><div><div>Hi, <br><br></div>Below you will find a quick list of places where you can actually find useful flatpak documentation. As you will see, the docs are in many different places (main site, flatpak's github wikis, some personal blogs, ...). Some information is duplicated and some is also outdated.<br><br></div><div>I propose to improve the main flatpak website adding a  documentation section, something like <a href="https://angular.io/docs/ts/latest/">Angular's website</a>, or <a href="https://ionicframework.com/docs/v2/">Ionic Framework</a> or create a manual at readthedocs like <a href="https://ostree.readthedocs.io/en/latest/">OStree.</a> (some of the information in flatpak's wiki is in Markdown already so most of the effort won't be wasted)<br><br></div><div>I can help setting up the things (readthedocs, jekyll, ...) and organizing a little bit the docs, but I would like to have some help (I'm not a native English speaker)<br><br></div><div>What do you think?<br><br></div><div>Best regards,<br></div><div>Jorge<br><br><br></div><div><br></div><div>Current docs:<br><br><b>Flatpak website</b><br> - Front page <a href="http://flatpak.org/index.html">http://flatpak.org/index.html</a><br>   - Intro to flatpak<br>   - Install and Run a Flatpak<br>   - Create an App with Flatpak<br>   - Get involved<br><br> - Getting flatpak <a href="http://flatpak.org/getting.html">http://flatpak.org/getting.html</a><br> - Apps  <a href="http://flatpak.org/apps.html">http://flatpak.org/apps.html</a> <br> - Runtimes <a href="http://flatpak.org/runtimes.html">http://flatpak.org/runtimes.html</a><br> - FAQ <a href="http://flatpak.org/faq.html">http://flatpak.org/faq.html</a><br> - Getting Started with Flatpak <a href="http://flatpak.org/developer.html">http://flatpak.org/developer.html</a><br>   - Key Concepts<br>   - Technologies<br>   - The flatpak Command<br>   - Anatomy of a Flatpak App<br>   - Building Simple Apps<br>   - Building More Complex Apps With flatpak-builder<br>   - Working with the Sandbox<br>   - Distributing Applications<br> - Bundling a Java Application with Flatpak <a href="http://flatpak.org/bundling-a-java-app.html">http://flatpak.org/bundling-a-java-app.html</a><br> - xdg-desktop-portal d-bus interfaces documentation <a href="http://flatpak.org/xdg-desktop-portal/portal-docs.html">http://flatpak.org/xdg-desktop-portal/portal-docs.html</a><br><br><br>Flatpak Github's repo: <a href="https://github.com/flatpak/flatpak">https://github.com/flatpak/flatpak</a><br><br>   - Wiki <a href="https://github.com/flatpak/flatpak/wiki">https://github.com/flatpak/flatpak/wiki</a><br><br>    Intro<br><br>    Information for Developers<br>        Example Apps and Runtimes<br>        Tips & Tricks<br><br>    Technical Details<br><br>        Application Filesystem<br>        Portals<br>        Sandbox<br>        Application Metadata<br><br>    Flathub<br><br>        Flathub<br>        Goals<br>        Workflows<br>        Relevant Art<br><br>    Miscellaneous<br><br>        Flatpak's History<br>        Flatpak in the Press<br><br>   - Release notes <a href="https://github.com/flatpak/flatpak/releases">https://github.com/flatpak/flatpak/releases</a><br>    <br>* xdg-desktop-portal's github repo: <a href="https://github.com/flatpak/xdg-desktop-portal">https://github.com/flatpak/xdg-desktop-portal</a> <br><br>* Man pages<br><br>* Alex Larsson blog<br>- Multi-part tutorial in how to create xdg-app applications. <a href="https://blogs.gnome.org/alexl/2016/02/19/building-an-xdg-app-part-1/">https://blogs.gnome.org/alexl/2016/02/19/building-an-xdg-app-part-1/</a><br><br>* Richard Hugges blog <a href="https://blogs.gnome.org/hughsie/">https://blogs.gnome.org/hughsie/</a><br>- Gnome Software integration with flatpak<br>- Add 3r party repos: <a href="https://blogs.gnome.org/hughsie/2016/04/27/3rd-party-fedora-repositories-and-appstream/">https://blogs.gnome.org/hughsie/2016/04/27/3rd-party-fedora-repositories-and-appstream/</a><br><br>* Mathias Classen's blog:<br>- Portals: Using GTK+ in a Flatpak <a href="https://blogs.gnome.org/mclasen/2016/07/08/portals-using-gtk-in-a-flatpak/">https://blogs.gnome.org/mclasen/2016/07/08/portals-using-gtk-in-a-flatpak/</a><br><br>* KDE's Guidelines and HOWTOs/Flatpak (<a href="https://community.kde.org/Guidelines_and_HOWTOs/Flatpak">https://community.kde.org/Guidelines_and_HOWTOs/Flatpak</a>)<br>    1 KDE Runtime<br>    2 Compile your application<br>    3 Contribute!<br>    4 Flatpak portals<br>        4.1 KDE implementation of portals<br><br></div><div><br></div></div>