I3: Mejore la distinción entre directivas de configuración y comandos

Creado en 20 mar. 2019  ·  4Comentarios  ·  Fuente: i3/i3

Estoy enviando un…

 [ ] Bicho
 [] Solicitud de función
 [x] Solicitud de documentación
 [ ] Otro (Por favor describa en detalle)

Comportamiento actual

En nuestros canales de soporte veo una confusión frecuente de directivas y comandos de configuración, específicamente cuando se trata de for_window y criterios de coincidencia. Deberíamos aclarar cuál es la diferencia entre config / commands, y que un usuario solo puede ejecutar comandos en tiempo de ejecución pero no cambiar la configuración.

i3 4.16

4.16 accepted documentation enhancement good first issue

Comentario más útil

Está bien, voy a llegar a él el. Gracias.

Todos 4 comentarios

Estaría dispuesto a hacer esto. ¿Sería esto tan simple como un archivo de texto o editaría el archivo de documentación?

Deberíamos actualizar la guía de usuario para esto ( docs/userguide ). Ya está separado en configuración y comandos, pero creo que la distinción no es lo suficientemente clara para los usuarios. Las secciones relevantes son

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

Particularmente en el último, creo que sería extremadamente útil una sugerencia explícita de que las directivas de configuración enumeradas en https://i3wm.org/docs/userguide.html#configuring no se pueden cambiar en tiempo de ejecución a menos que tengan un comando equivalente.

Está bien, voy a llegar a él el. Gracias.

Estoy de acuerdo, la sección for_window comienza con

Con el comando for_window ...

lo que definitivamente puede ser engañoso. Cambiar eso, hacer algo como "directiva" podría ayudar.

¿Fue útil esta página
0 / 5 - 0 calificaciones