градиент незнания - аааа, срочно продвигать этот термин, 50 оттенков незнания и осознанности) топ

Будьте реалистами, требуйте невозможного!

Хватит даже не градиента, а характеристической функции.

Особенно в командах, где почти по каждому вопросу bus-factor == 2

в связи с этим вопрос: верно ли, что f_{ignorance} = 1 – f_{knowledge} ?

Что есть $f$?

Добро пожаловать!

👋

Привет всем новичкам. Расскажите о себе что-нибудь )

Привет. Я Александр. Делаю проект nots.io  Мы даём возможность прикреплять документацию к коду (просто текст, маркдаун, картиночки, pdf-ки и даже файлы с гуглодиска). Привязать можно к функции, файлу, коммиту или бранче. Чтоб потом можно было быстро получить доступ из кода  прямо к документации — с nots или из IDE. Олсо мы отслеживаем изменения в коде, что даёт возможность показать, насколлько добавленная ранее дока релевантна на сегодняшний день.

однако красиво

На заметку админам: это не реклама, я сам попросил рассказать, не баньте )

😄

По сути: мне очень нравится индекс актуальности на каждом методе и очень не нравится, что доки хранятся отдельно от кода.  ))

Ну. На нашей стороне доки очень даже рядом с кодом 🙂

Ну они лежат у вас в БД. Что если я хочу их почитать или отредактировать где-то далеко от вайфая?

пока никак. Но мы думаем и работаем над этим

Хочу чтобы тулза работала как анализатор (по типу code coverage) и, может быть, как CMS над гитхабом, но доки чтобы остались в файлах с кодом.

Есть очень много причин, почему так. Например, на эти доки я буду ещё другие линтеры использовать, тот же vale. Потом, я упакую код в библиотеку и кто-то другой её заимпортит и будет прямо в среде разработки читать доки в коде.

Классный поинт, спасибо! Это, по-сути, может быть еще одним источников доков для нас, наравне с картинками/pdf-ками и файлами с гуглдрайва. Ты оффлайн написал текст, прогнал через линтеры, запушил и добавил у нас к нужному файлу.