2 files changed, 6 insertions, 3 deletions

diff --git a/README.md b/README.md
index 74f944ae4..085c8c0f6 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
     alt="rust-analyzer logo">
 </p>
 
-rust-analyzer is an **experimental** modular compiler frontend for the Rust language.
+rust-analyzer is a modular compiler frontend for the Rust language.
 It is a part of a larger rls-2.0 effort to create excellent IDE support for Rust.
 
 Work on rust-analyzer is sponsored by
diff --git a/docs/dev/README.md b/docs/dev/README.md
index 57162a47d..dcbab1a1d 100644
--- a/docs/dev/README.md
+++ b/docs/dev/README.md
@@ -135,12 +135,15 @@ panel and select `rust-analyzer`. This shows `eprintln!` as well. Note that
 
 To log all communication between the server and the client, there are two choices:
 
-* you can log on the server side, by running something like
+* You can log on the server side, by running something like
   ```
   env RA_LOG=lsp_server=debug code .
   ```
 
-* you can log on the client side, by enabling `"rust-analyzer.trace.server":
+  By default, logs go to stderr, `--log-file <PATH>` CLI argument overrides
+  that.
+
+* You can log on the client side, by enabling `"rust-analyzer.trace.server":
   "verbose"` workspace setting. These logs are shown in a separate tab in the
   output and could be used with LSP inspector. Kudos to
   [@DJMcNab](https://github.com/DJMcNab) for setting this awesome infra up!