diff --git a/man/file-hierarchy.xml b/man/file-hierarchy.xml
index 4b92d596cb..06f8fecf89 100644
--- a/man/file-hierarchy.xml
+++ b/man/file-hierarchy.xml
@@ -24,17 +24,21 @@
Description
Operating systems using the
- systemd1 system and service
- manager are organized based on a file system hierarchy inspired by UNIX, more specifically the hierarchy described
- in the File System Hierarchy
- specification and hier7, with various
- extensions, partially documented in the systemd1 system and
+ service manager are organized based on a file system hierarchy inspired by UNIX, more specifically the
+ hierarchy described in the File
+ System Hierarchy specification and hier7, with
+ various extensions, partially documented in the XDG Base Directory
Specification and XDG User
- Directories. This manual page describes a more generalized, though minimal and modernized subset of these
- specifications that defines more strictly the suggestions and restrictions systemd makes on the file system
- hierarchy.
+ Directories. This manual page describes a more generalized, though minimal and modernized subset
+ of these specifications that defines more strictly the suggestions and restrictions systemd makes on the
+ file system hierarchy. Note that this document makes no attempt to define the directory structure
+ comprehensively, it only documents a skeleton of a directory tree, that downstreams can extend. Because
+ of that traditional directories such as /usr/include/ or
+ /var/spool/ are not covered, even though it might (or might not) make a lot of sense
+ to include them in the structure of an actually deployed OS.
Many of the paths described here can be queried
with the