[Перевод] Man pages, которыми хочется пользоваться: как сделать их удобными
Man-страницы часто остаются главным способом разобраться с CLI-инструментом, но в реальной работе быстро найти нужную опцию или пример бывает непросто. В статье разберем практичные приемы, которые делают такую документацию удобнее: сводки опций, группировка по сценариям, шпаргалки, примеры, таблицы
![[Перевод] Man pages, которыми хочется пользоваться: как сделать их удобными](/uploads/e8add53a-10e1-4ff1-94cb-976ab31b20e6.jpg)
Image: Habr
Man-страницы часто остаются главным способом разобраться с CLI-инструментом, но в реальной работе быстро найти нужную опцию или пример бывает непросто. В статье разберем практичные приемы, которые делают такую документацию удобнее: сводки опций, группировка по сценариям, шпаргалки, примеры, таблицы и нормальная навигация в HTML-версиях. Всё на примерах Git, rsync, strace, curl, OpenBSD и GNU.
Перейти к статьеОригинальная статья
[Перевод] Man pages, которыми хочется пользоваться: как сделать их удобными
Опубликовано Habr