WIP: doc

doc/attributes.md

@@ -11,12 +11,12 @@ The YaST UI for creating and editing a user offers the following attributes:
 | full name | gecos | | | |
 | name | name | | | |
 | password | password | | | |
-| system mail | | | | |
+| system mail | receive_system_mail | | | See `MailAliases` module |
 | disable login | * password starting by `!` | | | |
 | uid | uid | | | |
 | home dir | home | | | | |
-| home dir permission | | | | |
-| empty home | | yes | | |
+| home dir permission | umask | yes | | `useradd -K UMASK=666` |
+| empty home | | yes | | `rm -rf` after creating. No way to ignore `/usr/etc/skel` |
 | Move to new location | | | yes |  |
 | Btrfs subvolume | btrfs_subvolume_home | | | |
 | Additional info | gecos | | | |
@@ -27,14 +27,16 @@ The YaST UI for creating and editing a user offers the following attributes:
 
 ### Home management
 
-### Creating a user
+This section describes how the YaST users client behaves when dealing with the user home.
+
+#### Creating a user
 
 * A user can be created with or without home.
 * To create a user without home, the *home dir* path should be set to empty.
 * The home can be created with or without default content (*empty home* checkbox).
 * The home can be created as Btrfs subvolume (*Btrfs subvol* checkbox).
 
-### Editing a user
+#### Editing a user
 
 * If the home path is changed, then a new home is created with the default content.
 * There is no way to create a new home without content (*empty home* checkbox is not available).
@@ -47,7 +49,7 @@ The YaST UI for creating and editing a user offers the following attributes:
 * If the home path is removed, then the home is removed from the user but the home itself (directory or subvolume) is kept.
 * There is no way to remove the home directory/subvolume.
 
-### Deleting a user
+#### Deleting a user
 
 * The home is removed too.