Guides → Welcome to SGEN Docs (Start here)

Welcome to SGEN Docs

The operator documentation for the SGEN platform — start here to find the right page for what you are trying to do.

This is the landing page for SGEN's documentation. It is written for operators — the people running sites on SGEN — and is structured so that the most common reasons to open the docs lead to the right page in one or two clicks.

If you are new to SGEN, the recommended path is: read this page, follow the orientation links into the Start Here pillar, then move into the Shared Concepts pillar to internalize the platform's operating model. After that, the per-area Reference and Guides will make sense in operator language without backfilling.

If you are returning to the docs after time away, the documentation map and the per-area Reference are the fastest re-entry points.

SGEN DOCUMENTATION
Five things you can do from this landing page
Orient yourself
Read what SGEN is, why it exists, and how the platform is structured.
Find the right surface
Pick the surface that matches your task: SG-Dashboard, SG-Builder.
Internalize the operating model
Read the Shared Concepts pillar to learn how publish, promote, role, and capture work across SGEN.
Open a Guide
Step-by-step procedures for the operations you run.
Track changes
What's New for shipped features · Changelog for status transitions.

What is this for?

This page is the entry point to SGEN documentation. Use it to orient yourself, to confirm you are in the right place for your question, and to pick the next page that matches what you are trying to do. The page is short on definitions and long on direction — definitions live in the Start Here pillar and the Shared Concepts pillar, both linked from here.

Good use cases

  • You created a SGEN account and want to know where to start.
  • You are returning to SGEN after time away and need a fast re-entry into the docs.
  • You are evaluating SGEN and want to read the operator-facing docs to assess fit.
  • You are explaining SGEN to a stakeholder and want a single link to share as a starting point.
  • You hit a "where does this question even belong?" moment and want a navigation page that helps you triage.

What NOT to use this for

  • Step-by-step procedures — open the relevant Guide.
  • Per-area Reference for a specific module — open the per-area Reference page.
  • Architecture-tier explanations of how SGEN is built — open the Architecture pillar.
  • Per-release shipped behavior change — open What's New or Changelog.

How this connects to other features


The three platform surfaces — pick the one that matches your task

SGEN exposes three operating surfaces. The right one to open depends on what you are trying to do.

SG-Dashboard — account-tier control

SG-Dashboard is the multi-site control surface. Use it for billing, per-site provisioning, account-level reporting, and managing the account user roster. Open it when your task is "across all our sites" rather than "inside this one site."

SG-Admin — per-site administration

SG-Admin is the per-site administrative surface. Use it for content (Pages, Posts, Products, Forms, Custom Objects, Locations, Events), modules (Store, Custom Objects, Configuration), publishing operations (save, publish, promote), and per-site user management. Open it when your task is "inside this one site."

SG-Builder — visual page composition

SG-Builder is the visual page editor. Use it to compose Pages and to apply per-page styling without writing template code. Open it when your task is "build or edit this specific page."

PLATFORM SURFACES
Pick the surface by what your task scope is
Account-tier
SG-Dashboard
Multi-site control · billing · provisioning · account roster · cross-site reporting
Open when: your task spans more than one site
Site-tier
SG-Admin
Per-site content · modules · publishing · per-site roster · settings
Open when: your task is inside one site
Page-tier
SG-Builder
Visual composition · per-page styling · structured components
Open when: your task is one specific page

The Start Here pillar — orientation reading

The Start Here pillar gives operators the orientation they need before diving into per-area work. Read these pages in order if you are new to SGEN.

The Shared Concepts pillar — operating model

The Shared Concepts pillar is the platform-tier operating model that every per-area Reference and Guide assumes. Read these five pages after the Start Here pillar.

Architecture pillar — how the platform is built

The Architecture pillar describes how SGEN is built rather than how it operates. Open it when you want the system-level framing.

  • Platform Architecture Overview — the architectural framing for the rest of the section.

Find the right page by question

Sometimes you arrive at the docs with a question and want to know which page answers it. The mapping below is for the most common starting questions.

QUESTION → PAGE
Find the right docs page by what you are asking
If you are asking...Read this page
"What is SGEN, in operator language?"What is SGEN
"How is SGEN built?"Platform Architecture Overview
"Why is staging different from live?"Environments and Site States
"What does Promote do?"Publishing Model
"Why can this user not publish?"Roles and Access
"Where is my Form submission?"Data and Tracking Model
"How do I connect a CRM?"Integrations Model + per-vendor Guide
"What is the docs structure?"Documentation Map

Definition

This page is the landing page for SGEN documentation — the canonical entry point at the docs root URL. Its role is orientation and routing rather than content depth. Definitions live elsewhere; this page directs the reader to where each definition is.

The landing page is intentionally short on operating-model content. The Shared Concepts pillar (linked above) carries that load. This page's job is to make that pillar discoverable for new readers and to be a stable re-entry point for returning ones.

Purpose

The purpose of this page is to be the smallest useful first page. A new reader should be able to read this page in under three minutes, follow the recommended links, and arrive at the right next page without having to guess which one applies to their question.

Scope

This page covers the docs landing at the orientation level — direction rather than definition.

The page covers:

  • The three platform surfaces and when to open each.
  • The Start Here pillar and recommended reading order for new operators.
  • The Shared Concepts pillar entry point.
  • The Architecture pillar entry point.
  • A question-to-page mapping for fast triage.
The page does not cover:
  • Definitions — those live in the linked pillars.
  • Procedures — those live in per-area Guides.
  • Per-area Reference — open the relevant area page.
  • Per-release behavior change — open What's New or Changelog.

What the docs are organized around

SGEN documentation is organized into four content categories. Knowing the categories speeds up navigation.

Category 1 — Documentation

Concept-and-orientation pages. The Start Here pillar, Shared Concepts pillar, Architecture pillar, and per-area overviews live here. Open Cat 1 when you want to understand how the platform works.

Category 2 — Reference

Per-feature definition pages. Each module, each setting, each surface has a Reference entry. Open Cat 2 when you want the structural shape of a specific feature.

Category 3 — What's New

Per-release announcements of shipped features. Open Cat 3 when you want to see what landed in the most recent release.

Category 4 — Changelog

Per-release status-transition record. Open Cat 4 when you want the history of a feature's behavior across releases.

DOCS STRUCTURE
Four content categories — pick by what you want to learn
Cat 1
Documentation
Concept + orientation · Start Here · Shared Concepts · Architecture · per-area overviews
Cat 2
Reference
Per-feature definition · per-module · per-surface · per-setting
Cat 3
What's New
Per-release announcements · what landed in the most recent release
Cat 4
Changelog
Per-release status transitions · feature history across releases

Examples

Example 1 — A new operator's first 15 minutes

A new operator opens this page. They read the orientation (under three minutes), open Welcome, then What is SGEN, then How This Documentation Works, then Documentation Map. They have an oriented mental model. Next they open the Shared Concepts Index and walk through the five pillar pages in reading order. They are now ready to open per-area Guides without backfilling vocabulary.

Example 2 — A returning operator triages a question

An operator who knows SGEN well opens this page after returning from a quarter away. They scan the question-to-page mapping, find their question (a CRM connector is failing), follow the link to Integrations Model, jump to the failure-handling section. The landing page handed off the triage in under a minute.

Example 3 — A stakeholder wanting context before a meeting

A stakeholder needs to understand SGEN at a high level before a partner conversation. They open this page, follow the link to What is SGEN, read it once, then come back to the landing and skim the three platform surfaces. They have the orientation they need for the conversation without committing to operator-tier reading depth.

Example 4 — A partner agency landing a new client account

An agency principal sets up a new SGEN account for a client. They send their team this page as the canonical onboarding link. The team works through Start Here and Shared Concepts in order, then opens the admin and SG-Dashboard Reference. The agency is ready to operate.

Example 5 — Confirming the docs are still aligned with SGEN's behavior

An experienced operator notices SGEN's publish flow looks slightly different from what they remember. They open this page, follow the question-to-page mapping to Publishing Model, and confirm whether the change is shipped (the page would be updated) or whether they are misremembering (the page matches their old memory and the difference is in their recall, not the platform).

Example 6 — Sharing a precise docs entry

An operator wants to send a colleague the right docs page for "why can this user not publish?" They open this landing, find that question in the mapping, copy the link to Roles and Access, and share that link directly. The colleague does not have to land on a generic docs root and search.


Documentation guidance

This page is the docs root landing. Treat its links as the canonical entry-points to each pillar. Per-area Guides should reference this page only when they need to send a reader back to orientation; deeper-context references should link to the specific Reference or shared-concept page directly.

For step-by-step procedures, open the relevant Guide. For the operating model, open Shared Concepts. For architectural framing, open Architecture. For per-area definitions, open the per-area Reference page.

Reading order

If you are new to SGEN, the recommended order is: this page → Welcome → What is SGEN → How This Documentation Works → Documentation Map → Shared Concepts Index → the five Shared Concepts siblings → per-area Reference for the area you need.

RECOMMENDED PATH
A new operator's first 15 minutes through the docs
STEP 01
Welcome to SGEN Docs · this page · 3 min
STEP 02
What is SGEN · operator-language platform definition · 4 min
STEP 03
How This Documentation Works · conventions + structure · 3 min
STEP 04
Documentation Map · full structure at a glance · 5 min
NEXT
Open Shared Concepts Index and walk the five-page operating-model pillar
VOCABULARY ANCHORS
Where the docs anchor each operator-tier term
TermDefined in
Environment / stateEnvironments and Site States
Save / publish / promotePublishing Model
Account-tier / site-tier roleRoles and Access
Capture / consent / retentionData and Tracking Model
Connector / configurationIntegrations Model
Surface (Dashboard / Admin / Builder)This page + per-area Reference
Architecture / SG-CorePlatform Architecture Overview

Related reading

Vocabulary cross-reference

  • Landing page — this page; the canonical entry point at the docs root URL.
  • Pillar — a coherent set of docs pages that together describe one operating concern (Start Here, Shared Concepts, Architecture).
  • Surface — a SGEN platform tier exposed to operators (SG-Dashboard, SG-Builder).
  • Per-area Reference — pages defining specific platform areas; assumes Shared Concepts.
  • Per-area Guide — step-by-step procedures inside a specific area; references Shared Concepts.
  • Cat 1 / Cat 2 / Cat 3 / Cat 4 — the four content categories the docs are organized into.
  • Question-to-page mapping — the table on this page that helps a reader locate the right docs entry by question.
  • Operator — a person running a SGEN site or account; the primary audience for these docs.
  • Re-entry point — the role this page plays for returning operators.
  • Orientation read — the recommended first-15-minutes path through the docs for new operators.
  • Stakeholder read — a shorter path for stakeholders; may stop at this page plus What is SGEN.
  • Partner agency read — the role this page plays for external agencies setting up SGEN for clients.
  • Docs root — the URL the landing page sits at; the canonical share target for "send the SGEN docs."
  • First-15-minutes path — the recommended new-operator reading sequence; designed to fit inside a single sitting.
  • Triage — the act of figuring out which docs page applies to a question; this landing's question-to-page mapping accelerates triage.
  • Routing link — a link from this landing into a pillar or per-area page; routes the reader rather than re-explaining content.
  • Operator-tier docs — documentation written for the people running SGEN sites; this landing's primary audience.
  • Stable share link — the property of this landing's URL: the docs root URL is stable so that external references and onboarding emails do not break across releases.
  • Pillar entrypoint — a link from this landing into the index of a pillar (Start Here, Shared Concepts, Architecture).
  • Multi-audience landing — the role this page plays for new operators, returning operators, stakeholders, partner agencies, and contractors with a single coherent entry.
On this page