I3: تحسين التمييز بين توجيهات وأوامر التكوين

تم إنشاؤها على ٢٠ مارس ٢٠١٩  ·  4تعليقات  ·  مصدر: i3/i3

أرسل ...

 [ ] خلل برمجي
 [] طلب المواصفات
 [x] طلب التوثيق
 [] أخرى (يرجى التوضيح بالتفصيل)

السلوك الحالي

أرى في قنوات الدعم الخاصة بنا ارتباكًا متكررًا في توجيهات وأوامر التكوين ، خاصة عندما يتعلق الأمر بـ for_window ومعايير المطابقة. يجب أن نوضح الفرق بين config / command ، وأن المستخدم يمكنه فقط تشغيل الأوامر في وقت التشغيل دون تغيير التكوين.

i3 4.16

4.16 accepted documentation enhancement good first issue

التعليق الأكثر فائدة

حسنًا ، سأصل إلى ملف. شكرا.

ال 4 كومينتر

سأكون على استعداد للقيام بذلك. هل سيكون هذا بسيطًا مثل ملف نصي ، أم سأقوم بتحرير ملف التوثيق؟

يجب علينا تحديث دليل المستخدم لهذا ( docs/userguide ). هو نفسه مقسم بالفعل إلى تكوين وأوامر ، لكنني أعتقد أن التمييز ليس واضحًا بما يكفي للمستخدمين. الأقسام ذات الصلة هي

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

على وجه الخصوص في الأخير ، هناك تلميح صريح مفاده أن توجيهات التكوين المدرجة ضمن https://i3wm.org/docs/userguide.html#configuring لا يمكن تغييرها في وقت التشغيل ما لم يكن لديهم أمر مكافئ سيكون مفيدًا للغاية على ما أعتقد.

حسنًا ، سأصل إلى ملف. شكرا.

أوافق ، يبدأ قسم for_window بـ

باستخدام الأمر for_window ...

والتي يمكن أن تكون مضللة بالتأكيد. تغيير ذلك بفعل شيء مثل "التوجيه" يمكن أن يساعد.

هل كانت هذه الصفحة مفيدة؟
0 / 5 - 0 التقييمات