doc: Improve introduction

As per swick's suggestions.
flatpak · Dec 29, 2023 · 9308bcf · 9308bcf
1 parent bbdacbc
commit 9308bcf
Showing 1 changed file with 9 additions and 4 deletions.
diff --git a/doc/introduction.rst b/doc/introduction.rst
@@ -1,12 +1,17 @@
 Introduction
 ============
 
-XDG Desktop Portal is a session service that provides D-Bus interfaces for
-sandboxed apps. These D-Bus interfaces can be used by sandboxed apps without
-granting special permissions on their sandbox manifest.
+XDG Desktop Portal is a session service that provides D-Bus interfaces for apps
+to interact with the desktop.
+
+Portal interfaces can be used by sandboxed and unsandboxed apps alike, but
+sandboxed apps benefit the most since they don't need special permissions to use
+portal APIs. XDG Desktop Portal safeguards many resources and features with a
+user-controlled permission system.
 
 The primary goal of portals is to expose common functionality and integration
-with the desktop without requiring apps to write desktop-specific code.
+with the desktop without requiring apps to write desktop-specific code, or
+loosen their sandbox restrictions.
 
 Terminology
 -----------