|
2 | 2 |
|
3 | 3 | 
|
4 | 4 |
|
| 5 | + |
| 6 | + |
5 | 7 | DocHub - инструмент описания архитектуры через код (Architecture as a code). Код архитектуры - ансамбль файлов на языках,
|
6 | 8 | решающих задачу описания. Поддерживаются:
|
7 | 9 |
|
| 10 | +* [Markdown](https://ru.wikipedia.org/wiki/Markdown) - язык разметки, созданный с целью обозначения форматирования в тексте; |
8 | 11 | * [PlantUML](https://plantuml.com/) - позволяет создавать диаграммы, используя простой и интуитивно понятный язык;
|
| 12 | +* [BPMN](https://dochub.info/entities/docs/blank?dh-doc-id=dochub.bpmn) - Поддерживается BPMN нотация описания бизнес-процессов с использованием [bpmnjs](https://bpmn.io/); |
9 | 13 | * [Mermaid](https://mermaid-js.github.io/mermaid/#/) - позволяет создавать диаграммы с использованием кода;
|
10 |
| -* [Markdown](https://ru.wikipedia.org/wiki/Markdown) - язык разметки, созданный с целью обозначения форматирования в тексте; |
11 | 14 | * [Swagger](https://swagger.io/) - язык описания HTTP API контрактов;
|
12 | 15 | * [AsyncAPI](https://www.asyncapi.com/) - язык описания событийных контрактов;
|
13 | 16 | * [SmartAnts](https://dochub.info/docs/dochub.smartants) - продвинутый инструмент презентации архитектуры.
|
@@ -295,9 +298,64 @@ npm run build
|
295 | 298 | * [Круглый стол 2021](https://youtu.be/tGulYbKW_Lg).
|
296 | 299 |
|
297 | 300 | # Сообщество
|
298 |
| - |
299 | 301 | * [Группа DocHubTeam](https://t.me/archascode)
|
300 | 302 | * [Канал "Архитектура как код"](https://t.me/dochubchannel)
|
301 | 303 |
|
| 304 | +# Динамика роста звезд на GitHub |
| 305 | + |
| 306 | +Каждая [звезда DocHub](#), это камень в фундамент подхода "Архитектура как код"! |
| 307 | + |
| 308 | +[](https://starchart.cc/RabotaRu/DocHub) |
| 309 | + |
302 | 310 | # Лицензия
|
303 | 311 | DocHub распространяется под лицензией Apache License 2.0 Open source license.
|
| 312 | + |
| 313 | +# Комьюнити-взнос за пользование продуктом |
| 314 | + |
| 315 | +## Проблема |
| 316 | + |
| 317 | +Цель создания DocHub — инструментализировать подход управления архитектурой кодом для его развития. DocHub разработан |
| 318 | +как [FOSS](https://en.wikipedia.org/wiki/Free_and_open-source_software) продукт, который должен развиваться сообществом. |
| 319 | + |
| 320 | +К сожалению, не все участники сообщества могут внести значимый вклад в кодовую базу DocHub. Однако сообщество уже велико |
| 321 | +и требует поддержки и развития. ***Примерно 97% пользователей зависят от результатов работы лишь 3% участников.*** |
| 322 | + |
| 323 | +Это, безусловно, тормозит инновации продукта, так как ресурсы расходуются на поддержку, а не на новшества. |
| 324 | +***Эту ситуацию необходимо изменить, чтобы сохранить импульс инноваций.*** |
| 325 | + |
| 326 | +## Решения проблемы - Прозрачность использования FOSS DocHub |
| 327 | + |
| 328 | +Одной из ключевых проблем любого продукта является доверие к нему. В ИТ это доверие заслужить сложно. |
| 329 | +Обычно метрикой надежности и перспективности продукта являются статусность его клиентов. DocHub не гнался за "лейблами" на первом этапе. |
| 330 | +Он ставил задачу создать реальную ценность для экспертов-инноваторов без "маркетингового давления" на них. |
| 331 | + |
| 332 | +Сегодня наше сообщество достаточно велико, и мы можем с уверенностью говорить о подтверждении ценности инструмента и подхода. Скромность более неуместна. |
| 333 | +Более того, она мешает его новым членам оценить масштаб и достижения нашего комьюнити. |
| 334 | + |
| 335 | +***Каждый пользователь DocHub может существенно помочь его развитию, опубликовав информацию о том, в какой компании и для каких задач он используется. |
| 336 | +Эта информация объединит наше сообщество, привлечет новых участников и расширит базу контрибьюторов.*** |
| 337 | +Направляйте информацию на ящик [r.piontik@mail.ru](mailto:r.piontik@mail.ru). Этим вы, безусловно, сделаете очень ценный вклад в развитие подхода "Архитектура как код". |
| 338 | + |
| 339 | +Начиная с релиза v3.13.1, в дополнение к лицензии Apache 2.0 вводится комьюнити-взнос в развитие DocHub. Он заключается в обязательстве пользователя |
| 340 | +***не скрывать использование DocHub***. Это обязательство также касается производных продуктов на основе кодовой базы DocHub. |
| 341 | + |
| 342 | +Информация ***о факте*** использования компанией DocHub может без ее явного согласия публиковаться в репозиториях продукта, в информационной |
| 343 | +пространстве комьюнити, в статьях, на конференциях и т.д. при наличии очевидных признаков такого использования (публичные заявления, форки кодовой базы, |
| 344 | +обсуждения в экспертных сообществах и т.п.). При этом, без согласия публикуется только сам факт использования. |
| 345 | + |
| 346 | + |
| 347 | +``` |
| 348 | + Например, если архитектор компании ООО "Креативные Технологии" опубликовал |
| 349 | + статью на Хабре "Развертывание сервисов с использованием DocHub", в |
| 350 | + репозитории DocHub может появиться информация об новом клиенте DocHub - |
| 351 | + ООО "Креативные Технологии". |
| 352 | + |
| 353 | + Никакой детальной информации об опыте использования без выраженного |
| 354 | + желания компании не появится. |
| 355 | +``` |
| 356 | + |
| 357 | +***Если по какой-либо причине считаете, что использование вами DocHub не может быть публичной информацией — прекратите его использование.*** |
| 358 | +Это противоречит цели создания DocHub как FOSS инструмента для развития инноваций в ИТ индустрии. |
| 359 | + |
| 360 | +По запросу организации на ящик [r.piontik@mail.ru](mailto:r.piontik@mail.ru) информация об использовании ей DocHub будет удалена. |
| 361 | +Одновременно с этим, компания берет на себя обязательства прекратить использовать DocHub в любых целях. |
0 commit comments