Информация об изменениях

Сообщение Re[10]: Книги по enterprise архитектуре основанные на пример от 10.12.2021 9:31

Изменено 10.12.2021 9:36 gyraboo

Re[10]: Книги по enterprise архитектуре основанные на примера
Здравствуйте, igor-booch, Вы писали:

G>>Но бросается в глаза, что в коде нет комментариев

IB>С комментариями проблема. Документирующие комментарии для пользователей,
IB>либо очевидны из названия члена (тупые комментарии писать не хочется),
IB>либо требуют развернутого объяснения, которое приведено в readme.
IB>Но некоторые комментарии, согласен, не мешало бы добавить.

Работать с простыней текста в Readme неудобно, удобнее, когда поясняющие комменты также есть в самом коде, разрабы же не будут каждый раз лезть в огромный readme, через изучение кода это часто делается.

G>>, а также коммиты все идут в одной ветке и с плохими коммит-мессаджами

IB>Да, я с ними не заморачивался,
IB>так как был и остаюсь единственным разработчиком.
IB>Если появится ещё разработчики, тогда месседжи конечно будут нужны,
IB>ещё можно сделать документацию для разработчика,
IB>коммит месседжи старых комитов вряд ли помогут

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

G>> коммьюнити у продукта тоже нет судя по всему?

IB>А где его взять? Вот думаю выступить на какой-нибудь встрече с докладом.

Конечно, нужен доклад, нужна статья в блоге с литературным описанием (завязка-интрига-развязка) какие проблемы эта библиотека решает, почему разработчики должны выбрать именно её?


G>> Еще бы не помешало написать, это как-то связано с Reactive Streams и проч. реактивными стандартами?

IB>Отсюда как бы очевидно (если предыдущие главы почитать). System.Reactive это пространство имен для реализации реактивного стандарта dotnet

G>>Нужно коммьюнити, ссылки на реально используемые проекты,

IB>Opensource проекты?

Для начала да. Чтобы посмотреть реальные кейсы применения твоей либы.

G>>также непонятно как дела уязвимостями и CVE.

IB>Уязвимости, наверное, такие же как для библиотек dotnet, на которые ссылается ObservableComputations. А ссылок мало и только на базовые библиотеки

Без этой инфы либа тоже не вкатится в энтерпрайз. Там же все либы постоянно чекаются на секьюрити. Если у либы нет этой инфы, либо если инфа есть и есть дыры в безопасности, то такая либа просто поступает на карантин и не собирается devsecops-пайплайном системы сборки.

И еще нужна четкая инфа по лицении продукта.
Re[10]: Книги по enterprise архитектуре основанные на пример
Здравствуйте, igor-booch, Вы писали:

G>>Но бросается в глаза, что в коде нет комментариев

IB>С комментариями проблема. Документирующие комментарии для пользователей,
IB>либо очевидны из названия члена (тупые комментарии писать не хочется),
IB>либо требуют развернутого объяснения, которое приведено в readme.
IB>Но некоторые комментарии, согласен, не мешало бы добавить.

Работать с простыней текста в Readme неудобно, удобнее, когда поясняющие комменты также есть в самом коде, разрабы же не будут каждый раз лезть в огромный readme, через изучение кода это часто делается.

G>>, а также коммиты все идут в одной ветке и с плохими коммит-мессаджами

IB>Да, я с ними не заморачивался,
IB>так как был и остаюсь единственным разработчиком.
IB>Если появится ещё разработчики, тогда месседжи конечно будут нужны,
IB>ещё можно сделать документацию для разработчика,
IB>коммит месседжи старых комитов вряд ли помогут

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

G>> коммьюнити у продукта тоже нет судя по всему?

IB>А где его взять? Вот думаю выступить на какой-нибудь встрече с докладом.

Конечно, нужен доклад, нужна статья в блоге с литературным описанием (завязка-интрига-развязка) какие проблемы эта библиотека решает, почему разработчики должны выбрать именно её?


G>> Еще бы не помешало написать, это как-то связано с Reactive Streams и проч. реактивными стандартами?

IB>Отсюда как бы очевидно (если предыдущие главы почитать). System.Reactive это пространство имен для реализации реактивного стандарта dotnet

G>>Нужно коммьюнити, ссылки на реально используемые проекты,

IB>Opensource проекты?

Для начала да. Чтобы посмотреть реальные кейсы применения твоей либы.

G>>также непонятно как дела уязвимостями и CVE.

IB>Уязвимости, наверное, такие же как для библиотек dotnet, на которые ссылается ObservableComputations. А ссылок мало и только на базовые библиотеки

Без этой инфы либа тоже не вкатится в энтерпрайз. Там же все либы постоянно чекаются на секьюрити. Если у либы нет этой инфы, либо если инфа есть и есть дыры в безопасности, то такая либа просто поступает на карантин и энтерпрайз-проекты, зависящие от неё, не собираются devsecops-пайплайном системы сборки.

И еще нужна четкая инфа по лицении продукта.