diff --git a/man/systemd.service.xml b/man/systemd.service.xml
index 25cca3d8d6..0e9fa3e732 100644
--- a/man/systemd.service.xml
+++ b/man/systemd.service.xml
@@ -292,7 +292,11 @@
will remove the file after the service has shut down if it still exists. The PID file does not need to be owned
by a privileged user, but if it is owned by an unprivileged user additional safety restrictions are enforced:
the file may not be a symlink to a file owned by a different user (neither directly nor indirectly), and the
- PID file must refer to a process already belonging to the service.
+ PID file must refer to a process already belonging to the service.
+
+ Note that PID files should be avoided in modern projects. Use or
+ where possible, which does not require use of PID files to determine the
+ main process of a service and avoids needless forking.