https://github.com/mii9000/das
Diagrams As Code
https://github.com/mii9000/das
Last synced: 5 months ago
JSON representation
Diagrams As Code
- Host: GitHub
- URL: https://github.com/mii9000/das
- Owner: mii9000
- Created: 2021-11-08T13:14:13.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-09-18T16:12:21.000Z (over 2 years ago)
- Last Synced: 2024-08-09T02:17:41.959Z (9 months ago)
- Language: Jupyter Notebook
- Size: 449 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
- jimsghstars - mii9000/das - Diagrams As Code (Jupyter Notebook)
README
Diagrams As Code
A working example on how to document your architecture and/or system diagrams as code
·
Report Bug
·
Request Feature
Table of Contents
## About The Project
[![Product Name Screen Shot][product-screenshot]](https://github.com/mii9000/das)
Diagrams are often created using visual tools. If its online, then its on another website associated with a specific account. If its offline then its on someone's desktop. In both cases, there is no single source to get the up-to-date document at any given time. There could be multiple versions circulating within the organization spreading misinformation.
Here's why your team should write system/architecture diagrams as code:
* **Generation** - Automatically generate diagrams writing minimal code; No need to waste time dragging to align blocks or dimensions of blocks.
* **Versioning** - Track, audit and review your diagrams like you would any piece of code through git
* **Single source of truth** - Bundled with your source code in the same git repository. If you have 1 source code repo then you have 1 source for the diagrams as well.### Built With
This boilerplate wraps the following projects along with other open-source plugins and tools to give you a complete setup to start working right away.
* [PlantUML](https://github.com/plantuml/)
* [Diagrams](https://github.com/mingrammer/diagrams/)
* [Visual Studio Code](https://code.visualstudio.com/)
* [Docker](https://docker.com/)## Getting Started
Use this repo as an example or boilerplate to add it to your source code git repo.
### Prerequisites
If on MacOS, make sure to have xcode cli installed
```sh
xcode-select --install
```### Installation
1. Clone the repo
2. Permission to execute the script
```sh
chmod +x ./setup-macos.sh
```
3. Execute
```sh
./setup-macos.sh
```The script will try to install all the dependencies if not present but there might be machine related settings because of which the script might fail. In that case, create an issue or try to read the script to install the requirements manually.
## Usage
1. Start with [C4](https://c4model.com/) diagrams using PlantUML. Follow the examples [Context](context.puml), [Container](container.puml) and [Component](component.puml) in this repo.
- To preview the diagrams : Open [VS Code Command Pallette](https://code.visualstudio.com/docs/getstarted/userinterface#_command-palette) and Select `PlantUML : Preview current diagram`
3. End with system diagrams using [Diagrams](https://diagrams.mingrammer.com/). Follow the example [diagram](diagram.ipynb) in this repo.
- To preview simply `Run All` the Jupyter notebook from top toolbar## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request[product-screenshot]: diagram.png