branching-strategy

From Forks to Branches: Streamlining Team Git Workflows

Dec 1, 2025 - 4 min read

Joaquin Romo

As part of a GitHub working group within a 50-person technical writing team, I recently helped lead our transition from a fork-based workflow to a centralized branching strategy. This shift simplified our collaboration model and reduced friction across four sub-teams. Here’s what we learned.

The Challenge

Our team of technical writers was using personal forks of our main documentation repository. While this approach worked, we identified several pain points:

Extra complexity for common operations
Confusion about which remote to push/pull from
Inconsistent workflows across team members
Limited value for our use case compared to open-source projects

The GitHub working group formed with representatives from each sub-team to evaluate whether forks still made sense for our internal collaboration model.

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