I3: Améliorer la distinction entre les directives de configuration et les commandes

Créé le 20 mars 2019  ·  4Commentaires  ·  Source: i3/i3

Je soumets un…

 [ ] Punaise
 [] Demande de fonctionnalité
 [x] Demande de documentation
 [ ] Autre (Veuillez décrire en détail)

Comportement actuel

Dans nos canaux d'assistance, je constate une confusion fréquente entre les directives et les commandes de configuration, en particulier en ce qui concerne for_window et les critères de correspondance. Nous devons préciser quelle est la différence entre config/commandes et qu'un utilisateur ne peut exécuter des commandes qu'au moment de l'exécution, mais pas modifier la configuration.

i3 4.16

4.16 accepted documentation enhancement good first issue

Commentaire le plus utile

D'accord, je vais y arriver le. Merci.

Tous les 4 commentaires

Je serais prêt à le faire. Serait-ce aussi simple qu'un fichier texte, ou devrais-je modifier le fichier de documentation ?

Nous devrions mettre à jour le guide de l'utilisateur pour cela ( docs/userguide ). Il est déjà séparé en config et en commandes, mais je pense que la distinction n'est pas assez claire pour les utilisateurs. Les sections pertinentes sont

  1. https://i3wm.org/docs/userguide.html#for_window
  2. https://i3wm.org/docs/userguide.html#list_of_commands

En particulier dans ce dernier, un indice explicite indiquant que les directives de configuration répertoriées sous https://i3wm.org/docs/userguide.html#configuring ne peuvent pas être modifiées au moment de l'exécution à moins qu'elles n'aient un équivalent de commande serait extrêmement utile, je pense.

D'accord, je vais y arriver le. Merci.

Je suis d'accord, la section for_window commence par

Avec la commande for_window ...

ce qui peut certainement être trompeur. Changer cela, faire quelque chose comme "directive" pourrait aider.

Cette page vous a été utile?
0 / 5 - 0 notes