185 похожих чатов

А просто заставить кого нибудь документацию писать уже не работает?

8 ответов

24 просмотра

Вопрос оптимизации и автоматизации

Нет, просто так не работает. Нужны механические способы валидации корректности и полноты документации. Вариант «пересматривать документацию» нереализуем

AlekseyK-Kluchnikov Автор вопроса

Согласен, тема документации вечная. Мне не нравится засилие разного инструментария. Кодер должен тесты писать, доку писать, СШ писать, в жире конфлюенсе что тоже писать, это все большущие инструменты. В результате код писать некогда ему

ну вообще набросать доку на ломаном русском кодер вполне может. копирайтер потом доработает

AlekseyK-Kluchnikov Автор вопроса

тут реч идет о специальном языке описания интефейсов

ты про сваг? там yaml разметка

Не всегда ни разу

js?

Похожие вопросы

Обсуждают сегодня

30500 за редактор? )
Владимир
47
Недавно Google Project Zero нашёл багу в SQLite с помощью LLM, о чём достаточно было шумно в определённых интернетах, которые сопровождались рассказами, что скоро всех "ибешни...
Alex Sherbakov
5
вы делали что-то подобное и как? может есть либы готовые? увидел картинку нокода, где всё линиями соединено и стало интересно попробовать то же в ddl на lua сделать. решил с ч...
Victor
8
Подскажите пожалуйста, как в CustomDrawCell(Sender: TcxCustomGridTableView; ACanvas: TcxCanvas; AViewInfo: TcxGridTableDataCellViewInfo; var ADone: Boolean); получить наз...
A Z
7
Ребят в СИ можно реализовать ООП?
Николай
33
https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_h_common.erl#L174 https://github.com/erlang/otp/blob/OTP-27.1/lib/kernel/src/logger_olp.erl#L76 15 лет назад...
Maksim Lapshin
20
Раз начали говорить про embassy, то присоединюсь со своими парой вопросов. 1) Есть ли сопоставимые аналоги для асинхронного кода в emdebbed? 2) Можно ли внутри задач embassy ...
NI_isx
6
Как передать управляющий символ в открытую через CreateProcess консоль? Собсна, есть процедура: procedure TRedirectThread.WriteData(Data: OEMString); var Written: Cardinal;...
Serjone
1
Он в одиночку это дело запилил или была какая-то команда?
Aquinary
12
~ 2m21s  nix shell github:nixos/nixpkgs#stack ~  stack ghc -- --version error: … while calling the 'derivationStrict' builtin at /builtin/derivation.nix:...
Rebuild your mind.
6
Карта сайта