Сообщение 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-пайплайном системы сборки.
И еще нужна четкая инфа по лицении продукта.
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-пайплайном системы сборки.
И еще нужна четкая инфа по лицении продукта.
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-пайплайном системы сборки.
И еще нужна четкая инфа по лицении продукта.