Skip to content

Commit 5b73c3b

Browse files
committed
doc: Improve docs/en/faq.md
Signed-off-by: Anthony D'Atri <[email protected]>
1 parent 0418191 commit 5b73c3b

File tree

1 file changed

+11
-9
lines changed

1 file changed

+11
-9
lines changed

docs/en/faq.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,9 @@ Read [JuiceFS Internals](development/internals.md) and [Data Processing Flow](in
122122

123123
### How to copy a large number of small files into JuiceFS quickly?
124124

125-
You could mount JuiceFS with [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options), which will write the small files into local disks first, then upload them to object storage in background, this could speedup coping many small files into JuiceFS.
125+
Mount JuiceFS with the [`--writeback` option](reference/command_reference.mdx#mount-data-cache-options),
126+
which will stage the small files on local storage, then flush them to backing
127+
storage in background.
126128

127129
See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more information.
128130

@@ -132,15 +134,15 @@ See ["Write Cache in Client"](guide/cache.md#client-write-cache) for more inform
132134

133135
## Mount Related Questions
134136

135-
### Can I mount JuiceFS without `root`?
137+
### Can I mount JuiceFS without `root` privileges?
136138

137-
Yes, JuiceFS could be mounted using `juicefs` without root. The default directory for caching is `$HOME/.juicefs/cache` (macOS) or `/var/jfsCache` (Linux), you should change that to a directory which you have write permission.
139+
Yes, JuiceFS could be mounted using `juicefs` without root privileges. The default directory for caching is `$HOME/.juicefs/cache` (macOS) or `/var/jfsCache` (Linux), you should change that to a directory which you have write permission.
138140

139141
See ["Read Cache in Client"](guide/cache.md#client-read-cache) for more information.
140142

141143
## Access Related Questions
142144

143-
### What other ways JuiceFS supports access to data besides mount?
145+
### What other ways does JuiceFS offer to access data?
144146

145147
In addition to mounting, the following methods are also supported:
146148

@@ -150,9 +152,9 @@ In addition to mounting, the following methods are also supported:
150152
- Docker Volume Plugin: A convenient way to use JuiceFS in Docker, please refer to ["Use JuiceFS on Docker"](deployment/juicefs_on_docker.md).
151153
- WebDAV Gateway: Access JuiceFS via WebDAV protocol
152154

153-
### Why the same user on host X has permission to access a file in JuiceFS while has no permission to it on host Y?
155+
### Why does a user on host X have permission to access a file in JuiceFS, but does not on host Y?
154156

155-
The same user has different UID or GID on host X and host Y. Use `id` command to show the UID and GID:
157+
Most likely the user has a different numeric UID or GID on the two hosts. Use the `id` command on each host to show each symbolic and numeric UID and GID:
156158

157159
```bash
158160
$ id alice
@@ -161,10 +163,10 @@ uid=1201(alice) gid=500(staff) groups=500(staff)
161163

162164
Read ["Sync Accounts between Multiple Hosts"](administration/sync_accounts_between_multiple_hosts.md) to resolve this problem.
163165

164-
### Does JuiceFS Gateway support advanced features such as multi-user management?
166+
### Does the JuiceFS Gateway support advanced features such as multi-user management?
165167

166-
The built-in `gateway` subcommand of JuiceFS does not support functions such as multi-user management, and only provides basic S3 gateway functions. If you need to use these advanced features, please refer to the [documentation](guide/gateway.md).
168+
The built-in `gateway` subcommand does not support functions including as multi-user management, and provides only basic S3 gateway functions. If you need to use these advanced features, please refer to the [documentation](guide/gateway.md).
167169

168-
### Is there currently an SDK available for JuiceFS?
170+
### Is there an SDK available for JuiceFS?
169171

170172
As of the release of JuiceFS 1.0, the community has two SDKs, one is the [Java SDK](deployment/hadoop_java_sdk.md) that is highly compatible with the HDFS interface officially maintained by Juicedata, and the other is the [Python SDK](https://github.com/megvii-research/juicefs-python) maintained by community users.

0 commit comments

Comments
 (0)