Size: a a a

DocOps-сообщество

2021 August 26

FM

Fox Mulder in DocOps-сообщество
вопрос - зачем?
источник

M

Max in DocOps-сообщество
Это Best Practice, но не требование
источник

M

Max in DocOps-сообщество
Например, имя файла может содержать пробелы)
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
окей, допустим, но если YAML человекочитаемый, а JSON - подмножество YAML, то JSON тоже человекочитаемый? и почему тогда просто не использовать JSON?
источник

M

Max in DocOps-сообщество
JSON однозначен. YAML позволяет много способов выразить одно и то же, некоторые из них - человекочитаемые)
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
ну вот у меня и была претензия к этому
источник

M

Max in DocOps-сообщество
А к кому претензия?
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
к человекочитаемости YAML
источник

M

Max in DocOps-сообщество
Не нравится - не используй
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
добровольно - не использую, мне не нравится, что он в куче мест, несмотря на очевидные недостатки
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
ну и да, агрессивное продвижение под знаменем человекочитаемости и совместимости с JSON (попахивает взаимоисключающими параграфами, да)
источник

M

Max in DocOps-сообщество
Мне кажется, этот комплейн находится за пределами тематики чата. А главное - здесь нет человека, которому его можно было бы адресовать.
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Я как человек на глаз не отличаю символ табуляции от пробелов без редактора, который их специально подсветит, а для YAML это важно отличать

Так что насчёт "достоинства человекочитаемости" я бы не согласился
источник

M

Max in DocOps-сообщество
У меня нет ни малейшего желания отстаивать здесь преимущества YAML, в которых я сам лично сомневаюсь. Я написал о мотивации его создания, которая объясняет особенности его синтаксиса.
источник

NV

Nick Volynkin in DocOps-сообщество
Это в целом просто решается: запрещаешь использовать табы и всё. :)
источник

NV

Nick Volynkin in DocOps-сообщество
Подозреваю, что Mkdocs собирает документы/страницы не по оглавлению, а вообще все, которые видит файлами. Заведите папку _archive, перемещайте туда файлы, которые пока что не используете.
источник

v

vladimir in DocOps-сообщество
папка не помогает) но спасибо за совет)
источник

NV

Nick Volynkin in DocOps-сообщество
Ну её надо ещё где-то в конфиге заигнорить или вынести выше папки с проектом
источник

v

vladimir in DocOps-сообщество
была такая идея, но решил обойтись изменением расширения
источник

NV

Nick Volynkin in DocOps-сообщество
filename.md.not
источник