user-guide.md add user-services documentation

Signed-off-by: Anna (navi) Figueiredo Gomes <navi@vlhl.dev>

1 files changed, 12 insertions, 0 deletions

diff --git a/user-guide.md b/user-guide.md
index 01b3add3..3c94a6fa 100644
--- a/user-guide.md
+++ b/user-guide.md
@@ -176,3 +176,15 @@ OpenRC has wrappers for many common output tasks in libeinfo.
 This allows to print colour-coded status notices and other things.
 To make the output consistent the bundled service scripts all use ebegin/eend to 
 print nice messages.
+
+# User services
+
+OpenRC supports managing services for users.
+
+The init scripts are loaded from /etc/user.d/init.d and
+${XDG_CONFIG_HOME:-${HOME}/.config}/openrc/init.d, with the latter taking priority.
+
+User services should have `#!/.../openrc-run --user` as the shebang.
+
+An instance of openrc --user is automatically instantiated when the user logs in
+via a pam module, from the `user` system init script, as user.<username>.