Skip to content

Release Process Proposal#208

Draft
jpshackelford wants to merge 6 commits intomainfrom
jps/release-process-proposal
Draft

Release Process Proposal#208
jpshackelford wants to merge 6 commits intomainfrom
jps/release-process-proposal

Conversation

@jpshackelford
Copy link
Copy Markdown
Contributor

@jpshackelford jpshackelford commented Sep 25, 2025

Description

This PR introduces a comprehensive OpenHands Enterprise Release Process Proposal that addresses current gaps in our release cadence, versioning strategy, and customer support expectations.

📖 Read the full proposal here (easier to read than the raw markdown below)

Key Proposal Highlights

  • Weekly Enterprise releases staggered 1 week behind SaaS for validation and stability
  • Support current + previous 2 releases (3 total supported versions) during rapid evolution phase
  • Unified versioning strategy with synchronized version numbers across all components
  • Automated release coordination to eliminate manual Git SHA tracking

Document Structure

  • Executive Summary: High-level overview of recommendations and benefits
  • Complete Table of Contents: Navigation for all sections and subsections
  • Enterprise Customer Analysis: Detailed breakdown of traditional vs. fast-moving enterprise patterns
  • Technical Implementation: Concrete automation and repository coordination strategies

Changes in This PR

  • Added comprehensive Executive Summary highlighting key recommendations
  • Added detailed Table of Contents with all sections and subsections
  • Enhanced Forward-Leaning/Fast-Moving Enterprises section with insights about regulated organizations
  • Added clarification about document scope and delivery model assumptions

Intent and Review Process

This PR is intended for collaborative review and decision-making. The goal is to use GitHub's review process to gather feedback, discuss alternatives, and refine the proposal through team collaboration.

Important: This document is not intended to land in main in its current form. Instead, this PR serves as:

  • A structured forum for reviewing and discussing the release process proposal
  • A way to gather input from stakeholders across engineering, product, and customer success
  • A collaborative space to refine recommendations before implementation

Please review the proposal and provide feedback on:

  • Release cadence recommendations
  • Support policy approach
  • Technical implementation strategy
  • Enterprise customer considerations
  • Any missing aspects or alternative approaches

Helm Chart Checklist

  • N/A - This PR only adds documentation, no Helm charts modified

Additional Notes

The proposal assumes continuation of Model 1 - Customer-Managed Installations (potentially streamlined with Replicated), while acknowledging Model 2 - Vendor-Managed Appliance Approach as a viable alternative that would require different strategies.

openhands-agent and others added 6 commits September 19, 2025 21:36
- Add proper subsection numbering (1.3.1, 1.3.2, 1.3.3)
- Enhance formatting with bold headers for better readability
- Add strategic context about delivery model decision-making
- Reorganize Additional Context section for clearer flow

Co-authored-by: openhands <openhands@all-hands.dev>
- Added comprehensive Executive Summary highlighting key recommendations and benefits
- Added detailed Table of Contents with all sections and subsections
- Enhanced Forward-Leaning/Fast-Moving Enterprises section with note about regulated organizations
- Added clarification in Two Delivery Models section about document scope and Replicated option

Co-authored-by: openhands <openhands@all-hands.dev>
- Add Section 4 with four key decision points
- Product classification: OHE as first-class product
- Version synchronization: aligned versioning with automation
- Release relationship: OHE-SaaS stagger approach
- Support policy: framework for version support and maintenance
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants