Skip to content

Commit 5723a1a

Browse files
authored
Merge pull request #573 from RabotaRu/context-uml
v3.13.1
2 parents 7cac8b9 + b821309 commit 5723a1a

File tree

9 files changed

+4391
-3890
lines changed

9 files changed

+4391
-3890
lines changed

README.md

Lines changed: 60 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,15 @@
22

33
![Инкрементальное развитие архитектуры](pics/interface.png)
44

5+
![GitHub License](https://img.shields.io/github/license/rabotaru/dochub)
6+
57
DocHub - инструмент описания архитектуры через код (Architecture as a code). Код архитектуры - ансамбль файлов на языках,
68
решающих задачу описания. Поддерживаются:
79

10+
* [Markdown](https://ru.wikipedia.org/wiki/Markdown) - язык разметки, созданный с целью обозначения форматирования в тексте;
811
* [PlantUML](https://plantuml.com/) - позволяет создавать диаграммы, используя простой и интуитивно понятный язык;
12+
* [BPMN](https://dochub.info/entities/docs/blank?dh-doc-id=dochub.bpmn) - Поддерживается BPMN нотация описания бизнес-процессов с использованием [bpmnjs](https://bpmn.io/);
913
* [Mermaid](https://mermaid-js.github.io/mermaid/#/) - позволяет создавать диаграммы с использованием кода;
10-
* [Markdown](https://ru.wikipedia.org/wiki/Markdown) - язык разметки, созданный с целью обозначения форматирования в тексте;
1114
* [Swagger](https://swagger.io/) - язык описания HTTP API контрактов;
1215
* [AsyncAPI](https://www.asyncapi.com/) - язык описания событийных контрактов;
1316
* [SmartAnts](https://dochub.info/docs/dochub.smartants) - продвинутый инструмент презентации архитектуры.
@@ -295,9 +298,64 @@ npm run build
295298
* [Круглый стол 2021](https://youtu.be/tGulYbKW_Lg).
296299

297300
# Сообщество
298-
299301
* [Группа DocHubTeam](https://t.me/archascode)
300302
* [Канал "Архитектура как код"](https://t.me/dochubchannel)
301303

304+
# Динамика роста звезд на GitHub
305+
306+
Каждая [звезда DocHub](#), это камень в фундамент подхода "Архитектура как код"!
307+
308+
[![Звезды на GitHub](https://starchart.cc/RabotaRu/DocHub.svg?variant=adaptive)](https://starchart.cc/RabotaRu/DocHub)
309+
302310
# Лицензия
303311
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 в любых целях.
Binary file not shown.

0 commit comments

Comments
 (0)