Modern Documentation Systems: Docusaurus, Starlight, and Mintlify Compared
Mar 3 · 10 min read · Modern Documentation Systems: Docusaurus, Starlight, and Mintlify Compared Your documentation site is the first thing developers interact with before using your tool. If it's slow, poorly organized, or hard to search, they'll move on. If it looks lik...
Join discussionBuild Better Open Source Software by Writing the Docs First
Dec 22, 2025 · 4 min read · We often feel a rush of excitement when a new idea hits. Most of us want to open our code editor and start typing logic immediately. We want to see the project run as soon as possible. However, as a project grows, we often realize that code does not ...
Join discussionMarkdown in 2025: Why It's Still Winning the Publishing Game
May 4, 2025 · 2 min read · “Markdown isn’t dead. In fact, it’s quietly running the internet.” We’re in 2025. AI tools are writing docs, Notion is the new Word, and rich editors are everywhere.And yet—Markdown is still a powerhouse. If you're a developer, writer, note-taker, o...
Join discussion
Managing Documentation as Code for Technical Writers (+ Tips for Beginners)
Mar 13, 2025 · 6 min read · Many times, managing technical documentation traditionally, using Content Management Systems (CMS) and Help Authoring Tools (HATs), can feel like a never-ending game of catch-up. It’s a blur trying to remember the last time I didn’t manage documentat...
Join discussionDocOps
Mar 7, 2025 · 3 min read · Para manter a competitividade nos negócios, agilidade é essencial. Equipes de desenvolvimento de software migraram para as metodologias de desenvolvimento Ágil e DevOps. Mas suas documentações se mantiveram na Idade das Pedras. Ainda em cascata, send...
Join discussion
How to Set Up Documentation as Code with Docusaurus and GitHub Actions
Feb 5, 2025 · 11 min read · For technical writers, keeping documentation up to date manually can be really frustrating. Issues like outdated guides, broken links, and missing updates are a pain, and they can make writers less productive. These issues can also make it harder for...
Join discussion
Content Inventory and Planning for Docs
Dec 18, 2024 · 5 min read · According to Kontent AI, Content Taxonomy refers to a scheme of classification used to organise and categorise content. Simply put, it’s a list of terms that helps you manage all files and assets in a content repository. It usually comprises three pa...
Join discussion
User Research Methods to Boost Your Information Architecture Design
Nov 14, 2024 · 4 min read · 💡 This article is part of a series titled Beyond DX: Building World-Class Developer Documentation for Web3. To effectively improve your documentation and drive developer adoption, you need to understand: Developer Journey: How do developers and u...
Join discussion
A Guide to Information Architecture and Taxonomy Structure for Web3 Docs
Nov 14, 2024 · 3 min read · According to the Interaction Design Foundation, Information architecture (IA) is the discipline of making information findable and understandable. It includes searching, browsing, categorising and presenting relevant and contextual information to hel...
Join discussion