diff -r fa48ab29abd2 -r 20a176d5a53e docs/src/add-repository.md
--- a/docs/src/add-repository.md	Sat Aug 05 09:36:03 2017 +0200
+++ b/docs/src/add-repository.md	Sat Aug 05 09:56:51 2017 +0200
@@ -1,6 +1,31 @@
 dav add-repository
 ==================
 
-The command runs an interactive assistant that creates a repository configuration and adds it to the config.xml file.
+This command runs an interactive assistant that creates a repository [configuration][1] and adds it to the config.xml file.
+
+[1]: ./configuration.html
 
 **Command alias:** add-repo
+
+The assistant firstly asks for a unique repository name.
+If you are not sure, which names are already in use, you can get a list of currently present repositories with [dav list-repositories][2].
+Then you specifiy the base URL and optional authentication information.
+Please keep in mind, that the password is stored base64 encoded in your configuration.
+If you do not want this to happen, leave the password blank.
+`dav` will ask you for the password when accessing the repository.
+Beware that you don't use password prompt in background jobs, though.
+A call of `add-repository` may look like this.
+
+	$ dav add-repository
+	Each repository must have an unique name.
+	name: myfirstrepo
+
+	Specify the repository base url.
+	url: https://mynas.local/webdav
+
+	User for HTTP authentication.
+	user (optional): mywebuser
+	password (optional): 
+
+[2]: ./list-repositories.html
+