Skip to content

Commit 0f8c95a

Browse files
authored
Merge pull request #574 from RabotaRu/v3.13.1
v3.13.1
2 parents c788617 + 5723a1a commit 0f8c95a

File tree

171 files changed

+8985
-3965
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

171 files changed

+8985
-3965
lines changed

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -198,4 +198,4 @@
198198
distributed under the License is distributed on an "AS IS" BASIS,
199199
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200200
See the License for the specific language governing permissions and
201-
limitations under the License.
201+
limitations under the License.

NOTICE

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
=========================================================================
2+
== NOTICE file for use with the Apache License, Version 2.0 ==
3+
=========================================================================
4+
5+
DocHub
6+
7+
Copyright (C) 2021 owner Roman Piontik R.Piontik@mail.ru
8+
9+
Licensed under the Apache License, Version 2.0 (the "License");
10+
you may not use this product except in compliance with the License.
11+
You may obtain a copy of the License at
12+
13+
http://www.apache.org/licenses/LICENSE-2.0
14+
15+
In any derivative products, you must retain the information of
16+
owner of the original code and provide clear attribution to the project
17+
18+
https://dochub.info
19+
20+
The use of this product or its derivatives for any purpose cannot be a secret.
21+
22+
Unless required by applicable law or agreed to in writing, software
23+
distributed under the License is distributed on an "AS IS" BASIS,
24+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
25+
See the License for the specific language governing permissions and
26+
limitations under the License.

README.md

Lines changed: 70 additions & 7 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) - продвинутый инструмент презентации архитектуры.
@@ -59,12 +62,17 @@ gantt
5962
POC mutators :done, 2023-07-01, 150d
6063
section Q4 2023
6164
Framework SEAF :done, 2023-10-01, 92d
62-
Time Machine :active, 2023-11-01, 250d
63-
Public metamodel repository :active, 2023-10-01, 200d
65+
Public metamodel repository :done, 2023-10-01, 200d
6466
section Q2 2024
65-
MVP mutators :active, 2024-01-01, 200d
66-
Process Disigner tool :2024-06-01, 90d
67-
Architectire Commutiny tool :2024-06-01, 90d
67+
MVP mutators :done, 2024-01-01, 200d
68+
Process Disigner tool :done, 2024-06-01, 120d
69+
Architectire Commutiny tool :2024-06-01, 200d
70+
section Q3 2024
71+
AaaC Community Architect Framework (CEAF) :active, 2024-06-17, 200d
72+
WEB DocHub IDE :active, 2024-09-14, 120d
73+
Digital Modeler :active, 2024-09-14, 120d
74+
section Q4 2024
75+
Time Machine :active, 2024-11-01, 90d
6876
6977
click plugins href "https://dochub.info/docs/dochub.plugins.intro"
7078
click smartants href "https://dochub.info/docs/dochub.smartants"
@@ -290,9 +298,64 @@ npm run build
290298
* [Круглый стол 2021](https://youtu.be/tGulYbKW_Lg).
291299

292300
# Сообщество
293-
294301
* [Группа DocHubTeam](https://t.me/archascode)
295302
* [Канал "Архитектура как код"](https://t.me/dochubchannel)
296303

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

distrib/vscode/dochub-0.1.0.vsix

-13.6 MB
Binary file not shown.

distrib/vscode/dochub-0.1.1.vsix

-14.3 MB
Binary file not shown.

distrib/vscode/dochub-0.1.2.vsix

-14.4 MB
Binary file not shown.

distrib/vscode/dochub-0.1.3.vsix

-14.5 MB
Binary file not shown.

0 commit comments

Comments
 (0)