doc

docs/neovim.md

@@ -215,22 +215,10 @@ Le réglage `vim.opt.clipboard = "unnamedplus"` relie le registre par défaut de
 
 La section `Clipboard` doit indiquer qu'un outil de presse-papiers a été trouvé.
 
-### Mise à jour des plugins
-
-Pour rechercher les mises à jour disponibles pour les plugins gérés par `vim.pack` :
-
-```text
-:lua vim.pack.update()
-```
-
-Vérifiez les changements proposés, puis utilisez `:write` pour les accepter. Redémarrez ensuite Neovim pour utiliser les plugins mis à jour. Pour contrôler l'état du gestionnaire de plugins :
-
-```text
-:checkhealth vim.pack
-```
-
 ## Ruby
 
+Installez d'abord Ruby avec `rbenv` en suivant la fiche [Ruby avec rbenv](ruby.md), puis utilisez le même Ruby pour les outils ci-dessous.
+
 ### Ruby LSP
 
 Installez `ruby-lsp` avec le Ruby utilisé par votre environnement :
@@ -239,7 +227,7 @@ Installez `ruby-lsp` avec le Ruby utilisé par votre environnement :
 $ gem install ruby-lsp
 ```
 
-Vérifiez ensuite le client LSP dans Neovim :
+Ouvrez un fichier Ruby, puis vérifiez que le client LSP est bien détecté dans Neovim :
 
 ```text
 :checkhealth vim.lsp
@@ -328,9 +316,33 @@ Les commandes suivantes suffisent pour commencer :
 | `Space r` | Ouvrir Grug Far pour rechercher et remplacer |
 | `Ctrl-]` | Aller à la définition |
 | `Ctrl-t` | Revenir après un saut vers une définition |
+| `K` | Afficher les informations LSP sur le symbole sous le curseur |
 | `Ctrl-s` | Afficher la signature de la méthode en mode insertion (raccourci LSP natif) |
+| `Ctrl-x Ctrl-o` | Afficher manuellement la complétion LSP en mode insertion |
 | `u` | Annuler |
 
+### IRB
+
+Pour explorer Ruby, découvrir des méthodes, consulter leur documentation ou tester rapidement du code, gardez de préférence IRB dans un split de Konsole dédié, en dessous de Neovim :
+
+```sh
+$ irb
+```
+
+IRB fournit sa propre complétion. `Tab` parcourt les propositions et `Shift-Tab` revient à la proposition précédente.
+
+Quelques commandes utiles :
+
+| Commande | Action |
+| --- | --- |
+| `show_doc Array#select` | Afficher la documentation avec RI |
+| `ls objet` | Afficher les méthodes, constantes et variables accessibles |
+| `show_source nom` | Afficher le code source lorsqu'il est disponible |
+| `help` | Afficher les commandes IRB |
+| `exit` | Quitter IRB |
+
+IRB reste l'outil privilégié pour explorer Ruby. Dans Neovim, `K`, `Ctrl-s` et `Ctrl-x Ctrl-o` servent surtout à obtenir rapidement des informations contextuelles sans quitter le fichier en cours.
+
 ### Grug Far
 
 `Space r` ouvre Grug Far dans un split vertical. En mode visuel, la sélection courante est utilisée pour préremplir le texte recherché.
@@ -351,6 +363,8 @@ Pour vérifier l'installation ou diagnostiquer un problème :
 :checkhealth grug-far
 ```
 
+### Telescope
+
 Dans Telescope :
 
 | Commande | Action |
@@ -363,7 +377,13 @@ Dans Telescope :
 | `Ctrl-t` | Ouvrir dans un nouvel onglet |
 | `Ctrl-c` | Fermer Telescope |
 
-La ligne de commande de Neovim propose automatiquement les complétions lorsque vous saisissez une commande après `:`.
+Pour vérifier l'installation ou diagnostiquer un problème :
+
+```text
+:checkhealth telescope
+```
+
+La ligne de commande de Neovim propose automatiquement les complétions pour les commandes `:` et les recherches `/` et `?`.
 
 ## Ignorer des fichiers du projet
 
@@ -377,4 +397,20 @@ $ printf 'doc/\n' > .rgignore
 
 `ripgrep` prendra ce fichier en compte pour les recherches effectuées par Telescope lorsqu'il est utilisé comme moteur de recherche.
 
+## Maintenance
+
+Pour rechercher les mises à jour disponibles pour les plugins gérés par `vim.pack` :
+
+```text
+:lua vim.pack.update()
+```
+
+Vérifiez les changements proposés, puis utilisez `:write` pour les accepter. Redémarrez ensuite Neovim pour utiliser les plugins mis à jour.
+
+Pour contrôler l'état du gestionnaire de plugins :
+
+```text
+:checkhealth vim.pack
+```
+
 [Retour au guide principal](../README.md)