diff -r ddb5e8f2a43d -r 3070d72f54af docs/src/put.md
--- a/docs/src/put.md	Sat Aug 05 11:33:17 2017 +0200
+++ b/docs/src/put.md	Sat Aug 05 13:35:27 2017 +0200
@@ -3,13 +3,14 @@
 
 **`put [-pcR] [-k <key>] [-L <lock>] <url> <file>`**
 
-Uploads a file or a directory. When uploading a file and the url points to
+Uploads a file or a directory. When uploading a file while the url points to
 an existing collection, a resource inside this collection with the file's name is created. When the url points to a non-existing resource, the resource is
 created.
 
-When uploading a directory, you need to specify the -R option. It uploads
+When uploading a directory, you need to specify the **`-R`** option. It uploads
 all files in the directory to the specified url, but it does not create a
 collection for the directory itself.
+You may use [dav mkdir][1] to create this collection beforehand.
 
 **`-p`** disable file name encryption and decryption
 
@@ -20,8 +21,9 @@
 **`-k <key>`** use the specified key for encryption. The key must be configured in
   the config.xml file
 
-**`-L <lock>`** use a lock token. See [dav lock][1]
+**`-L <lock>`** use a lock token. See [dav lock][2]
 
-[1]: ./lock.html
+[1]: ./mkdir.html
+[2]: ./lock.html