Skip to content
This repository was archived by the owner on Feb 4, 2023. It is now read-only.

ti-broish/docs

Repository files navigation

Ти Броиш - Документация

Документация на архитектурата и структурата на Ти Броиш

Този проект съдържа самият код на документацията в Markdown и PlantUML файлове.

За да разгледате, документацията вижте генерирания сайт.

Ако искате да допринесете към документацията, вижте по-надолу.

Принципи

Прочетете C4 Model за основните концепции.

Модели пред диаграми

Диаграмите са важна част от визуализацията и комуникацията на дадена архитектура. Но диаграмите не бива да бъдат първоизточника на информацията. Моделите трябва да са гръбнака, представящи субектите и връзките в една система - коректно и точно без възможност за объркване. Разнообразни диаграми могат да бъдат генерирани автоматично от тези модели.

Конкретни диаграми могат да бъдат създадено ръчни, за да подчертаят конкретна сфера по-добре с презентационна цел.

Модели в код

Спрямо Docs as Code, моделите в кода ни позволява:

  • лесно да ползваме контрол на версии,
  • да дискутираме предложения с прецизност при преглеждане на кода,
  • да преизползваме модели на множество места.

Инсталиране

git clone [email protected]:Da-Bulgaria/ti-broish-docs.git
cd ti-broish-docs
npm install

Използване

To build the website locally, run:

npm start

Open http://localhost:3232/.

Инструментариум

Използваме C4Builder с C4 PlantUML, Markdown и Docsify за да генерираме йерархичеб сайт с документация от номерирани файлове.

Моля, следвайте сегашната файлова структура.

Лиценз

Тази документация е собственост на Политическа партия "Движение Да, България" и не може да бъде публикувана, споделянеа или модифицирана без писмено разрешение.

About

Документация за платформата Ти Броиш

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •