Это кажется, что man pages — текст, написанный человеками для человеков.
На самом деле™ man pages должны допускать отображение в терминале, браузере и некоторые ещё включают требование печати на бумаге как отдельный формат вывода. А когда есть HTML для браузера, то дополнительно всплывает требование семантической корректности этого HTML’я, чтоб его понимали (а) поисковики и (б) скринридеры для слепых и слабовидящих. И всё, troff с его чисто презентационной разметкой не катит.
А вот из DocBook, Texinfo и разных лёгких разметок можно было бы выбирать. Маркдаун в плане выражения семантики довольно беден; Python, например, документируется в reStructuredText.
Я когда-то после реанимации был вынужден ездить по городу за документами, а у меня было медицинское ограничение - не поднимать ничего тяжелее 3кг, иначе говоря - не совершать руками действий, требующих усилий больших, чем для поднятия груза в 3кг.
Разумеется, ни бронедвери подъездов жилых домов, ни сдвигаемые вбок двери маршруток-газелей, ни двери в военкомате не соответствовали этому ограничению.
В следующем посте обсуждают ИИ, который выполняет работу на 85%, и этого будет достаточно. Вот и с markdown вместо XML дела обстоят также: для 85% нужд хватит, а на остальных - да хрен с ними.
![[personal profile]](https://www.dreamwidth.org/img/silk/identity/user.png){kind=small}
no subject
Date: 2023-05-10 01:43 pm (UTC)no subject
Date: 2023-05-10 02:13 pm (UTC)Да. И Я говорю про текст для человеков, написанный человеками (aka man pages).
no subject
Date: 2023-05-10 02:37 pm (UTC)no subject
Date: 2023-05-10 03:32 pm (UTC)Это кажется, что man pages — текст, написанный человеками для человеков.
На самом деле™ man pages должны допускать отображение в терминале, браузере и некоторые ещё включают требование печати на бумаге как отдельный формат вывода. А когда есть HTML для браузера, то дополнительно всплывает требование семантической корректности этого HTML’я, чтоб его понимали (а) поисковики и (б) скринридеры для слепых и слабовидящих. И всё, troff с его чисто презентационной разметкой не катит.
А вот из DocBook, Texinfo и разных лёгких разметок можно было бы выбирать. Маркдаун в плане выражения семантики довольно беден; Python, например, документируется в reStructuredText.
no subject
Date: 2023-05-13 11:42 pm (UTC)Разумеется, ни бронедвери подъездов жилых домов, ни сдвигаемые вбок двери маршруток-газелей, ни двери в военкомате не соответствовали этому ограничению.
В следующем посте обсуждают ИИ, который выполняет работу на 85%, и этого будет достаточно. Вот и с markdown вместо XML дела обстоят также: для 85% нужд хватит, а на остальных - да хрен с ними.