docs: Add section about Edit Prediction modes (#26683)

Danilo Leal created 9 months ago

To go along the upcoming blog post as well as the new menu item options
(https://github.com/zed-industries/zed/pull/26680).

Release Notes:

- N/A

Change summary

docs/src/completions.md    | 15 +++++++++++++++
docs/theme/css/general.css |  9 ++++++++-
2 files changed, 23 insertions(+), 1 deletion(-)

Detailed changes

docs/src/completions.md

@@ -40,6 +40,21 @@ But, if you haven't come across the banner, start using Zed's Edit Prediction by
 },
 ```
 
+### Switching modes
+
+Zed's Edit Prediction comes with two different display modes:
+
+1. `eager` (default): predictions are displayed inline as long as it doesn't conflict with language server completions
+2. `subtle`: predictions only appear inline when holding a modifier key (`alt` by default)
+
+Toggle between them via the `mode` key:
+
+```json
+"edit_predictions": {
+  "mode": "eager" | "subtle"
+},
+```
+
 ### Conflict With Other `tab` Actions {#edit-predictions-conflict}
 
 By default, when `tab` would normally perform a different action, Zed requires a modifier key to accept predictions:

docs/theme/css/general.css

@@ -169,7 +169,14 @@ h6:target::before {
 }
 .content ol {
   line-height: 1.8;
-  padding-left: 1.8em;
+
+  ::marker {
+    font-size: 1.4rem;
+  }
+
+  li {
+    padding-left: 0;
+  }
 }
 .content ul {
   line-height: 1.8;