documentation

Content Branching Strategy for Documentation Sites

Sep 17, 2025 - 3 min read

Joaquin Romo

When building a professional documentation site like DevPortals.tech, maintaining content quality while enabling rapid development requires a strategic approach to version control. Here’s the branching strategy I’ve implemented for managing documentation content lifecycle.

The Challenge

Building a portfolio-quality documentation site presents unique challenges:

Quality vs. Speed: You want to publish frequently but maintain professional standards
Work-in-Progress Content: Some sections need extensive research and iteration
Professional Presentation: Your live site represents your expertise to potential employers
Development Flexibility: You need space to experiment without affecting production

Starlight Sidebar Configuration Strategies: Manual vs Autogenerate

Sep 17, 2025 - 4 min read

Joaquin Romo

While building DevPortals.tech, I ran into a common documentation site challenge: how do you organize sidebar navigation when you want some content to appear in a specific order (like overview pages) while still automatically including new files as you create them?

This is the kind of practical problem that comes up constantly when building documentation sites, and the solution isn’t always obvious from the docs.

From reST to MDX: Why Documentation Frameworks Are Evolving

Aug 10, 2025 - 3 min read

Joaquin Romo

Documentation frameworks are not just technical choices — they reflect cultural shifts in how we think about developer experience.

For years, reStructuredText (reST) powered serious technical documentation, especially in the Python and scientific communities.
Today, Markdown and MDX dominate modern developer portals. Why? Let’s explore this shift.