Edits to user guide + added filesystem section

1 files changed, 9 insertions, 3 deletions

diff --git a/content/docs/user_guide/debugging.md b/content/docs/user_guide/debugging.md
index f8a5999fd..c6f5cc772 100644
--- a/content/docs/user_guide/debugging.md
+++ b/content/docs/user_guide/debugging.md
@@ -21,6 +21,10 @@ To enable debug and system call logging, add the `runtimeArgs` below to your
 }
 ```
 
+> Note: the last `/` in `--debug-log` is needed to interpret it as a directory.
+> Then each `runsc` command executed will create a separate log file.
+> Otherwise, log messages from all commands will be appended to the same file.
+
 You may also want to pass `--log-packets` to troubleshoot network problems. Then
 restart the Docker daemon:
 
@@ -29,8 +33,10 @@ sudo systemctl restart docker
 ```
 
 Run your container again, and inspect the files under `/tmp/runsc`. The log file
-with name `boot` will contain the strace logs from your application, which can
-be useful for identifying missing or broken system calls in gVisor.
+ending with `.boot` will contain the strace logs from your application, which can
+be useful for identifying missing or broken system calls in gVisor. If you are
+having problems starting the container, the log file ending with `.create` may
+have the reason for the failure.
 
 ## Stack traces
 
@@ -46,7 +52,7 @@ docker run --runtime=runsc --rm -d alpine sh -c "while true; do echo running; sl
 sudo runsc --root /var/run/docker/runtime-runsc/moby debug --stacks 63254c6ab3a6989623fa1fb53616951eed31ac605a2637bb9ddba5d8d404b35b
 ```
 
-> Note: `--root` variable is provided by docker and is normally set to 
+> Note: `--root` variable is provided by docker and is normally set to
 > `/var/run/docker/runtime-[runtime-name]/moby`. If in doubt, `--root` is logged to
 > `runsc` logs.