Setting Up an Organization – GitHub

👥 Enterprise Admins 🎯 Reduced support dependency 📅 2025

Improved task success during enterprise setup by clarifying a complex, conditional process for establishing organizational structure and ownership.

Impact

This procedural article became a key reference in the enterprise onboarding flow, helping new administrators self-serve critical configuration steps without support intervention. By clarifying a complex process with conditional paths based on enterprise type and account status, the article improved user comprehension and reduced confusion around organizational management constraints during early-stage setup.

At a Glance

Audience

New GitHub Enterprise Cloud administrators during onboarding

Goal

Clarify conditional setup paths; enable self-serve configuration; reduce support calls

Collaboration

Content design team, onboarding guide stakeholders

Tools

Git/GitHub, Markdown, Liquid, YAML, docs-as-code

View the Work

Screenshot (click to expand)

Article showing procedural steps for setting up an organization in GitHub Enterprise

Screenshot captured October 2025.

Behind the work (click to expand)

Context:

This article supports enterprise administrators during the early onboarding phase as they establish organizational structure, roles, and ownership. The procedure addresses a complex process with conditional steps based on enterprise type and account status. The goal was to ensure administrators could complete setup without support intervention. This article was authored as part of the broader GitHub Enterprise Onboarding Guide initiative.

Activities:

  • Conducted hands-on testing to validate each step and confirm UI behavior across different enterprise configurations
  • Structured content for clarity and logical flow, reflecting two possible paths ("create new organization" vs. "invite existing organization")
  • Authored clear, step-by-step instructions supported by plain language and consistent formatting
  • Linked related topics across the onboarding documentation to reinforce information flow and minimize redundancy