Despite the massive growth of docs-as-code as a documentation ethos, I continue to be surprised, year after year, by the lack of robust docs-as-code tools. Most days it feels as if docs-as-code was a giant standing on feet of clay, on the fragile toolchains that we use to create our documentation in all kinds of software companies, from startups to unicorns.

Все знают комикс XKCD про 14 competing standards. Типа, 14 конкурирующих стандартов это проблема, давайте придумаем один, который их объединит, ой, теперь у нас 15 конкурирующих стандартов.

Обычно его вспоминают, когда хотят кого-нибудь заткнуть: типа, че ты высовываешься, бери то, что есть и не придумывай.

И это все круто и понятно, кроме, собственно, одного момента: а как, по-вашему, эта ситуация должна разрешиться? Просто сидеть и ждать, когда тринадцать из четырнадцати отомрут? Да тут скорее я на пенсию выйду.

Штука в том, что если стандартов реально 14, значит, они все решают какую-то часть проблемы и не решают какую-то другую. То есть просто сидеть и ждать, когда один победит, явно не вариант, потому что победить ни один не может по определению.

А это значит, что все еще есть пространство перекомбинировать плюсы и выкинуть минусы, сделать 15-й, да, но не простым повторением, а с прицелом на то самое доминирование. Раз 14 стандартов до сих пор не могут выбрать победителя, может быть, нужно что-то качественно…