Skip to content
DevPortals.Tech
Docs Portfolio
Blog

documentation

4 posts with the tag “documentation”

Self-Documenting Your Dev Workflow: How Writing Guides Made Me 3x Faster

- 6 min read
Joaquin Romo

There’s a moment in every developer’s journey when you finally realize: “I should have documented this the first time.”

Mine came after spending two hours debugging why my Sanity Studio components weren’t showing up in production—even though they worked perfectly on localhost. The problem? I had forgotten that my blog actually consists of two separate applications that need independent deployments.

This is the story of how writing documentation for “future me” accidentally made my development process 3x faster.

Content Branching Strategy for Documentation Sites

- 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

Section titled “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

- 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

- 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.