Điểm:0

Trợ giúp về các tùy chọn chức năng

lá cờ jp

Tôi đang viết tài liệu cho hàm bash mà tôi đang viết. Nó hỗ trợ một tùy chọn màu có thể là một trong --vlt --blu --grn --ylw --orn --pur --red --wht. Tôi đã sử dụng phần mô tả sau đây nhưng không chắc liệu nó có đủ dễ hiểu hay không và muốn cải thiện phần trợ giúp mô tả này.

 --COLR
   Tùy chọn màu
 
   --COLR tóm tắt | --COLR tóm tắt
   -----------------+----------------
   --vlt Tím | --orn cam
   --blu Xanh lam | --pur Tím
   --grn Xanh | --đỏ đỏ
   --ylw Vàng | --wht Trắng
Artur Meinild avatar
lá cờ vn
Tôi tin rằng điều này sẽ chủ yếu dựa trên ý kiến ​​​​cá nhân và do đó lạc đề ở đây. Tôi khuyên bạn nên thực hiện một cuộc khảo sát người dùng với những người nên đọc tài liệu và lấy ý kiến ​​​​của họ. Chúc mừng!
lá cờ jp
Có chương trình dòng lệnh nào thực hiện loại danh sách bảng tùy chọn này không?
terdon avatar
lá cờ cn
Tôi chắc chắn sẽ có. Mỗi tác giả chương trình được tự do làm bất cứ điều gì họ thích trong các tùy chọn của họ. Nhưng vì đây không thực sự là một câu hỏi về Ubuntu nên tôi đồng ý với Artur rằng nó không lạc đề. Cá nhân tôi sẽ chỉ có tùy chọn `--color` nhận các giá trị (ví dụ: `--color blue`) và sau đó cung cấp danh sách các giá trị được chấp nhận trong thông báo trợ giúp.
Điểm:0
lá cờ sa

Tài liệu hàm bash sẽ dễ hiểu hơn nếu bạn thay thế từ mơ hồ "Tóm tắt" bằng cụm từ mô tả hơn "Tên màu". Nếu là một hướng dẫn được gọi từ thiết bị đầu cuối bởi Đàn ông lệnh, bạn cũng có thể cải thiện khả năng đọc bằng cách định dạng dòng đầu tiên dưới dạng văn bản in đậm như thường được thực hiện trong các trang thủ công.

--COLR
  Tùy chọn màu

  --COLR Tên màu | --COLR Tên màu
  ---------------------- + ----------------------
  --vlt Tím | --orn cam
  --blu Xanh lam | --pur Tím
  --grn Xanh | --đỏ đỏ
  --ylw Vàng | --wht trắng     

Đăng câu trả lời

Hầu hết mọi người không hiểu rằng việc đặt nhiều câu hỏi sẽ mở ra cơ hội học hỏi và cải thiện mối quan hệ giữa các cá nhân. Ví dụ, trong các nghiên cứu của Alison, mặc dù mọi người có thể nhớ chính xác có bao nhiêu câu hỏi đã được đặt ra trong các cuộc trò chuyện của họ, nhưng họ không trực giác nhận ra mối liên hệ giữa câu hỏi và sự yêu thích. Qua bốn nghiên cứu, trong đó những người tham gia tự tham gia vào các cuộc trò chuyện hoặc đọc bản ghi lại các cuộc trò chuyện của người khác, mọi người có xu hướng không nhận ra rằng việc đặt câu hỏi sẽ ảnh hưởng—hoặc đã ảnh hưởng—mức độ thân thiện giữa những người đối thoại.