

Being able to capture decisions, general documentation, technical breakdowns, temporary notes, all without being forced to use some kind of template.Developers love to use Markdown, some proprietary markup or Mermaid to write content and create diagrams, whereas non-developers just want to see what they are doing.įor me, having a documentation platform that promotes collaboration is a crucial element of successful software architecture.Everybody is continuously asking themselves were to put their meeting notes, brainstorm content and decisions.Miro is used for structural documentation, because it’s the most versatile tool they have.People are sending around copies of those documents over e-mail.Unless somebody remembers where a document is, there’s no central place to find stuff.You’ll find Word and PowerPoint documents all over the place, including OneDrive, folders within Microsoft Teams, local machines and SharePoint.People use PowerPoint to capture notes during meetings.Documents can be found in Microsoft Word, PowerPoint, Miro, SharePoint wikis and Azure DevOps wikis.For example, do you recognize some of the below symptoms? Although I love coding, I also really care about being able to track my notes and my breakdowns, but more importantly, to capture architectural decisions, development guidelines, and share technical information through internal blogs.īut this seems to be a hard problem to solve. Other people just want to be able to write down their notes and being able to find them back. Developers are usually pretty opinionated about that, if only because they want to ensure nothing gets in the way of doing the thing they love most: coding. Confluence, a wiki that will make people collaborate on documentationĪ very common discussion within organizations that do software development is what tool to use for documentation.
