Add README.md

README.md

@@ -0,0 +1,34 @@
+# Ark (org.kde.ark)
+
+[Homepage](https://kde.org/applications/en/utilities/org.kde.ark) |
+[User documentation](https://userbase.kde.org/Ark) |
+[Sources](https://invent.kde.org/utilities/ark)
+
+## Reporting bugs
+
+**Before filling a bug, please test if the bug is reproduceable with the
+classic non-Flatpak version of this application.**
+
+- If the bug is only reproducible with the **Flatpak version** of this
+  application, please file an [Issue here][issue].
+
+- If the bug is also reproducible with the **non-Flatpak version** of this
+  application, please take a look at the [currently opened bugs][bugs] and if
+  it has not been reported yet, file a bug at
+  [bugs.kde.org](https://bugs.kde.org).
+
+**If you have any doubt, please file an [Issue here][issue].**
+
+## Permissions rationale
+
+This applications requests the following permissions for:
+
+- X11 support: `--share=ipc`, `--socket=x11`
+- Wayland & OpenGL support: `--socket=wayland`, `--device=dri`
+- Required for accessibility: `--talk-name=org.a11y.Bus`
+- Required to extract an archive to a user chosen path: `--filesystem=host`.
+  This could potentially be removed in favor of a portal based approach but
+  this currently requires development work.
+
+[issue]: https://github.com/flathub/org.kde.ark/issues/new
+[bugs]: https://bugs.kde.org/buglist.cgi?bug_status=UNCONFIRMED&bug_status=CONFIRMED&bug_status=ASSIGNED&bug_status=REOPENED&product=ark&query_format=advanced