summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2018-12-07 15:34:14 -0500
committerAtomic Bot <atomic-devel@projectatomic.io>2018-12-10 07:26:51 +0000
commita8dff96aebb40bcf550910496e33f4b468f6b9d4 (patch)
treebf6e0858c98fbc1c09690a4b89d030d7f548151e /README.md
parentd613bc053271a75c6cb9ffc9a0957488387e9fde (diff)
downloadflatpak-a8dff96aebb40bcf550910496e33f4b468f6b9d4.tar.gz
Add some docs for the overall git repo layout
Trying to make things less confusing. Closes: #2404 Approved by: alexlarsson
Diffstat (limited to 'README.md')
-rw-r--r--README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/README.md b/README.md
index a943371c..4f120648 100644
--- a/README.md
+++ b/README.md
@@ -79,3 +79,18 @@ location it is likely that this will not be found by dbus and
policykit. However, if the system installation is synchronized,
you can often use the system installed helper instead - at least
if the two versions are close in versions.
+
+Floor plan
+==========
+
+The flatpak project consists of multiple pieces, and it can be
+a bit challenging to find your way around at first. Here is a
+quick intro to the major components of the repo:
+* common: contains the library, libflatpak. It also contains various pieces of code that are shared between the library, the client and the services. Non-public code can be recognized by having a `-private.h` header file.
+* app: the commandline client. Each command has a `flatpak-builtins-` source file
+* data: D-Bus interface definition files
+* session-helper: The flatpak-session-helper service, which provides various helpers for the sandbox setup at runtime
+* system-helper: The flatpak-system-helper service, which runs as root on the system bus and allows non-root users to modify system installations
+* portal: The Flatpak portal service, which lets sandboxed apps request the creation of new sandboxes
+* doc: The sources for the documentation, both man pages and library documentation
+* tests: The testsuite