<!-- mobian-agent-page publisher="dailydev" canonical="https://daily.dev/posts/how-to-document-your-architecture--tloalotxg" -->

---
title: How to document your architecture? | daily.dev
description: Every application has an architecture. It might be something simple or something complex. Every architecture constantly evolves. It is important to not only be...
canonical: https://daily.dev/posts/how-to-document-your-architecture--tloalotxg
twitter:card: summary_large_image
twitter:site: @dailydotdev
og:type: website
og:site_name: daily.dev
og:title: How to document your architecture? | daily.dev
og:description: Every application has an architecture. It might be something simple or something complex. Every architecture constantly evolves. It is important to not only be...
og:url: https://daily.dev/posts/how-to-document-your-architecture--tloalotxg
og:image: https://api.daily.dev/og/posts/tlOalOTXg.png
og:image:alt: How to document your architecture?
og:image:width: 1200
og:image:height: 630
og:locale: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# How to document your architecture?

**[The Software House](https://daily.dev/sources/tsh)** · 5 min read · 98 upvotes · 7 comments

## Summary

Every application has an architecture. It might be something simple or something complex. Every architecture constantly evolves. It is important to not only be able to pass everything related to it to the team but also to keep that information up to date. In this article, I focus on how we share such information at The Software House.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://tsh.io/blog/how-to-document-your-architecture/>

## Community discussion

Top comments from developers on daily.dev.

**@berkmann18** · 4 upvotes

> Summary:
> - C4 for high to low-level architecture diagrams (https://c4model.com).
> - ERD for modelling database schemas.
> - Flowchart diagram.
> - Sequence diagram.
>
> I 100% second the C4 model (including Simon Brown' suggestion in not using the 4th level).
> And the neat thing about those, it's the fact that you can use Diagram-as-Code tools (e.g. PlantUML, C4-PlantUML, Graphviz/dot) to model them.

**@itsmnthn** · 1 upvotes

> awesome read!

**@ghost** · 1 upvotes

> Useful if you want to k now how different architecture diagrams are used.

**@amodhshenoy** · 0 upvotes

> Very informative post!

**@robus** · 0 upvotes

> This is the best starters advise for the full stack developers.

## Similar posts on daily.dev

- [Don’t just attend KubeCon \+ CloudNativeCon, Merge Forward your experience\!](https://daily.dev/posts/don-t-just-attend-kubecon-cloudnativecon-merge-forward-your-experience--l0rpp73x8) · CNCF · 1 upvotes · 0 comments
- [Announcing H2 2026 KCDs](https://daily.dev/posts/announcing-h2-2026-kcds-m96goajm1) · CNCF · 1 upvotes · 0 comments
- [Two months of Open Community Groups](https://daily.dev/posts/two-months-of-open-community-groups-asf52zhbs) · CNCF · 0 upvotes · 0 comments
- [CNCF Unveils Schedule for KubeCon \+ CloudNativeCon Europe 2026](https://daily.dev/posts/cncf-unveils-schedule-for-kubecon-cloudnativecon-europe-2026-ikhcoa5cb) · CNCF · 2 upvotes · 0 comments
- [CNCF Debuts KubeCon \+ CloudNativeCon Japan 2026 Schedule](https://daily.dev/posts/cncf-debuts-kubecon-cloudnativecon-japan-2026-schedule-xp5pyudub) · CNCF · 1 upvotes · 0 comments

---

Tags: [#architecture](https://daily.dev/tags/architecture), [#containers](https://daily.dev/tags/containers), [#general-programming](https://daily.dev/tags/general-programming)

[View this post on daily.dev](https://daily.dev/posts/how-to-document-your-architecture--tloalotxg)

```json
{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]}
{"@context":"https://schema.org","@type":"TechArticle","headline":"How to document your architecture?","url":"https://daily.dev/posts/how-to-document-your-architecture--tloalotxg","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/how-to-document-your-architecture--tloalotxg"},"datePublished":"2021-05-27T10:15:58.201Z","dateModified":"2026-03-15T03:21:13.998Z","description":"Every application has an architecture. It might be something simple or something complex. Every architecture constantly evolves. It is important to not only be...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/37c80c683c674e4ff7790c7a99af6a55","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/37c80c683c674e4ff7790c7a99af6a55","isAccessibleForFree":true,"articleSection":"The Software House","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"The Software House","logo":"https://media.daily.dev/image/upload/t_logo,f_auto/v1/logos/db4741926fbd4427bd9c2150af9f5597","url":"https://daily.dev/sources/tsh"},"commentCount":7,"discussionUrl":"https://daily.dev/posts/how-to-document-your-architecture--tloalotxg","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":98},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":7}],"keywords":"architecture,containers,general-programming","timeRequired":"PT5M"}
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"The Software House","item":"https://daily.dev/sources/tsh"},{"@type":"ListItem","position":3,"name":"How to document your architecture?"}]}
{"@context":"https://schema.org","@type":"WebPage","@id":"https://daily.dev/posts/how-to-document-your-architecture--tloalotxg","comment":[{"@type":"Comment","text":"Summary:\n\nC4 for high to low-level architecture diagrams (https://c4model.com).\nERD for modelling database schemas.\nFlowchart diagram.\nSequence diagram.\n\nI 100% second the C4 model (including Simon Brown’ suggestion in not using the 4th level).\nAnd the neat thing about those, it’s the fact that you can use Diagram-as-Code tools (e.g. PlantUML, C4-PlantUML, Graphviz/dot) to model them.","datePublished":"2021-05-29T20:18:34.069Z","url":"https://daily.dev/posts/tlOalOTXg#c-QeUdKcfW5","author":{"@type":"Person","name":"Maximilian Berkmann","url":"https://daily.dev/berkmann18","image":"https://avatars0.githubusercontent.com/u/8260834?v=4"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":4}},{"@type":"Comment","text":"awesome read!","datePublished":"2021-05-27T23:46:19.136Z","url":"https://daily.dev/posts/tlOalOTXg#c-sub9eSz_b","author":{"@type":"Person","name":"Manthankumar Satani","url":"https://daily.dev/itsmnthn","image":"https://media.daily.dev/image/upload/s--XpFWj1ND--/f_auto/v1749054653/avatars/avatar_iBTDQoV5Y?_a=BAMClqUq0"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"Useful if you want to k now how different architecture diagrams are used.","datePublished":"2021-05-27T12:08:04.942Z","url":"https://daily.dev/posts/tlOalOTXg#c-TuzN1h4PQ","author":{"@type":"Person","name":"Deleted user","url":"https://daily.dev/ghost","image":"https://media.daily.dev/image/upload/s--hNIUzLiO--/f_auto/v1705327420/public/ghost_vlftth"},"interactionStatistic":{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":1}},{"@type":"Comment","text":"Very informative post!","datePublished":"2021-06-22T16:12:44.233Z","url":"https://daily.dev/posts/tlOalOTXg#c-PGOZoPlpz","author":{"@type":"Person","name":"Amodh Shenoy","url":"https://daily.dev/amodhshenoy","image":"https://media.daily.dev/image/upload/f_auto/v1624378409/avatars/_cESeOXHh"}},{"@type":"Comment","text":"This is the best starters advise for the full stack developers.","datePublished":"2021-06-27T09:11:05.531Z","url":"https://daily.dev/posts/tlOalOTXg#c-CoCFirkuZ","author":{"@type":"Person","name":"Kuldeep Bhatt","url":"https://daily.dev/robus","image":"https://avatars1.githubusercontent.com/u/1011504?v=4"}}]}
```