I3: Verbessern Sie die Unterscheidung zwischen Konfigurationsanweisungen und Befehlen

Erstellt am 20. März 2019  ·  4Kommentare  ·  Quelle: i3/i3

Ich reiche ein…

 [ ] Insekt
 [] Featureanfrage
 [x] Dokumentationsanfrage
 [ ] Sonstiges (Bitte ausführlich beschreiben)

Aktuelles Verhalten

In unseren Support-Kanälen sehe ich eine häufige Verwechslung von Konfigurationsanweisungen und -befehlen, insbesondere wenn es um for_window und Übereinstimmungskriterien geht. Wir sollten klarstellen, was der Unterschied zwischen config/commands ist und dass ein Benutzer nur Befehle zur Laufzeit ausführen, aber keine config ändern kann.

i3 4.16

4.16 accepted documentation enhancement good first issue

Hilfreichster Kommentar

Okay, ich komme dazu. Danke.

Alle 4 Kommentare

Dazu wäre ich gerne bereit. Wäre dies so einfach wie eine Textdatei oder würde ich die Dokumentationsdatei bearbeiten?

Wir sollten das Benutzerhandbuch dafür aktualisieren ( docs/userguide ). Es selbst ist bereits in Config und Befehle unterteilt, aber ich denke, die Unterscheidung ist den Benutzern nicht klar genug. Relevante Abschnitte sind

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

Insbesondere bei letzterem wäre ein expliziter Hinweis, dass die unter https://i3wm.org/docs/userguide.html#configuring aufgelisteten config-Direktiven nicht zur Laufzeit geändert werden können, es sei denn, sie haben zufällig ein Befehlsäquivalent, denke ich, wäre sehr nützlich.

Okay, ich komme dazu. Danke.

Ich stimme zu, der Abschnitt for_window beginnt mit

Mit dem Befehl for_window ...

was definitiv irreführend sein kann. Das Ändern dieser Funktion wie "Richtlinie" könnte helfen.

War diese Seite hilfreich?
0 / 5 - 0 Bewertungen