more docs

Author: MenxLi

Readme.md

@@ -35,8 +35,4 @@ The authentication can be acheived through one of the following methods:
 
 You can refer to `frontend` as an application example, `lfss/api/connector.py` for more APIs. 
 
-By default, the service exposes all files to the public for `GET` requests, 
-but file-listing is restricted to the user's own files.  
-Please refer to [docs/Permission.md](./docs/permission.md) for more details on the permission system. 
-
-More can be found in the [docs](./docs) directory.
+More information can be found in the [documentation](https://menxli.github.io/lfss/).

docs/permission.md

@@ -7,7 +7,7 @@ There are different access levels for different users, which determine what oper
 - <span class="perm">admin/all</span>: all permissions including `GET`/`PUT`/`POST`/`DELETE` and listing directories.
 - <span class="perm">write</span>: same as admin except for [directory configuration](./lfssdir.md) file.
 - <span class="perm">read</span>: only `GET` permission and listing directories.
-- <span class="perm">none</span>: no permissions.
+- <span class="perm">none</span>: no permissions as above, but may have `GET` permission on files via direct link, depending on the file and path-owner's **permission** settings (refer to the [section below](#file-access-with-get-permission)).
 
 :::info
 **directory** path ends with `/` and **file** does not end with `/`.

docs/server-intro.md

@@ -13,15 +13,16 @@ Now the server is running at `http://localhost:8000`.
 
 By default, the data will be stored in `.storage_data`. 
 You can change the storage directory using the `LFSS_DATA` environment variable, 
-more details can be found in [environment-variables](./environment-variables.md).
+more details can be found in [Environment variables](./environment-variables.md).
 
 ## Create a user
 Create a user using the following command:
 ```bash
 lfss-user add <username> <password> --admin
 ```
 This command will create an admin user, which can manage other users. 
-More user management commands can be found in `lfss-user --help` and `lfss-user <subcommand> --help`.
+More sub commands can be found in `lfss-user --help` and `lfss-user <subcommand> --help`. 
+Details on user management can be found in [User Management](./userman.md).
 
 ## Interact with the server
 Please refer to [Client-side tools](./client-intro.md) for more details on how to use the client CLI tools to interact with the server.

docs/virtual-user.md

@@ -11,7 +11,10 @@ This makes virtual users essentially "access keys" to some users' paths.
 
 The virtual user always have a name starting with `.v-`, 
 a typical virtual user name looks like `.v-{tag}-{id}`. 
-The tag is used to identify the purpose of the virtual user, and the id is a unique random string.
+The tag is used to identify the purpose of the virtual user, and the id is a unique random string. 
+
+The virtual user is hidden from the user list by default. 
+To list virtual users, you can use the `-a/--all` flag with the `lfss-user list` command.
 
 To create a virtual user, you can use either the CLI command or the admin API. For example: