Привет. Не про док и не про опс, но близко в плане способов описания чего-то и связи этого с реальным миром.

https://medium.com/codeiq/object-oriented-programming-the-trillion-dollar-disaster-️-92a4b666c7c7

Что скажете? 🙂

There’s no objective and open evidence that OOP is better than plain procedural programming.

Ох лол

Мне кажется, кто-то давно не пробовал хорошей процедурщины без всякого solid.

Хмм... А вы прочитали статью?

Я прочитал, тем более что она не слишком свежая. Там не про ООП, конечно, а про энтерпрайз и 'наиболее популярными становятся наименее удачные решения'. Если энтерпрайз начнет все делать в ФП, то будет ещё хуже (

Ну или так же хуже )

Я еще раз ее пересмотрел по диагонали, а там все те же. Аппеляция к авторитетам, пассажи в стиле "У вас неправильное ООП, а вот тут правильное. И вообще если бы вы взяли ФП!" и так далее. (Очень классно смотрится аппеляция к Линусу, благодаря которому код ядра до сих пор не полностью покрыт тестами)

Вместо того, что бы чисто признать, что бизнесу не очень интересен идеологически правильно написанный продукт и они не готовы платить цену за большое количество опытных программистов и методологически выверенный код, нужно начинать рассказывать, что ваш код написан методологически неправильно, а если бы вы писали в методологии Х у вас было бы лучше. Не было бы

Я же не говорю, что в статье "все правильно". Просто первая нападка была очень "мимо кассы".

Но некоторое количество здравых идей я там увидел. Все reactive, observables и binding, без которых сейчас не обходится фронтэнд - это messages, так или иначе.

Ребят, всем привет!
Мы у себя только обдумываем переход на другой подход создания документации.

Подскажите, в чем плюсы-минусы rST по сравнению с Asciidoc? Что лучше начать использовать, если опыта с документацией как код ещё не было?

Зависит от списка ваших требований, какие вам нужны элементы в документации

Что-то в одном языке лучше, что-то в другом, какие таргеты хотите

Если нет опыта, стартаните с markdown. Как упретесь в ограничения - пробуйте тот, в котором есть то, чего нет в md. Аскидок и РСТ со старту могут быть оверкиллами

Особенно если все эти технологии оплачиваются за 50-60к )

Мы вот как раз упёрлись серьезно в ограничения маркдауна. Буду топить за переход на аскидоктор

сорта и виды легких языков разметки это как писать для разных аудиторий, каждому нужно своё

А что делать бизнесу в тот момент, когда техпис упрется в ограничения? Что делать потом с готовыми наработками в md?
Или тут расчет на то, что техпис достаточно быстро наткнется на ограничения и не успеет сделать много? )

pandoc!

Ты хотел сказать, pandoc и неопределенное количество доработок напильником:)

Или конвертить, как упомянули выше (благо все тулзы опенсорс и делается это с полпинка, качественно и давно) или во время изучения. Благо это не разница а-ля JavaScript vs Go, например, это два вечера тыканий в VSCode

(как автоматических, так и ручных)