diff --git a/README.md b/README.md
index 4cada764de2b..7debf7c3b3ca 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ To build rust-analyzer, you need:
 * latest stable rust for language server itself
 * latest stable npm and VS Code for VS Code extension (`code` should be a path)
 
-For setup for other languages, see [./docs/users].
+For setup for other languages, see [./docs/users](./docs/users).
 
 ```
 # clone the repo
@@ -39,10 +39,10 @@ $ cargo install-lsp
 ## Documentation
 
 If you want to **contribute** to rust-analyzer or just curious about how things work
-under the hood, check the [./docs/dev] folder.
+under the hood, check the [./docs/dev](./docs/dev) folder.
 
 If you want to **use** rust-analyzer's language server with your editor of
-choice, check [./docs/users] folder. It also contains some tips & tricks to help
+choice, check [./docs/users](./docs/users) folder. It also contains some tips & tricks to help
 you be more productive when using rust-analyzer.
 
 ## Getting in touch
diff --git a/docs/user/README.md b/docs/user/README.md
index b25e152d0a08..8de46981b06f 100644
--- a/docs/user/README.md
+++ b/docs/user/README.md
@@ -14,7 +14,7 @@ to execute
 $ rustup component add rust-src
 ```
 
-See [./features.md] document for a list of features that are available.
+See [./features.md](./features.md) document for a list of features that are available.
 
 ## VS Code
 
@@ -46,7 +46,7 @@ bugs!
 It's better to remove existing Rust plugins to avoid interference.
 
 Beyond basic LSP features, there are some extension commands which you can
-invoke via <kbd>Ctrl+Shift+P</kbd> or bind to a shortcut. See [./features.md]
+invoke via <kbd>Ctrl+Shift+P</kbd> or bind to a shortcut. See [./features.md](./features.md)
 for details.
 
 ### Settings