Skip to content

Expand ExpertOps messaging and reorganize offerings directory#176

Open
brianamarie wants to merge 2 commits into
mainfrom
expertops-service-catalog
Open

Expand ExpertOps messaging and reorganize offerings directory#176
brianamarie wants to merge 2 commits into
mainfrom
expertops-service-catalog

Conversation

@brianamarie
Copy link
Copy Markdown
Collaborator

Summary

  • Adds ExpertOps subscription and delivery detail in offerings/expertops/service-catalog.md (entitlements, periodic deliverables, hours model, SLAs, onboarding, access requirements), sourced from field deck material that was not previously in canonical messaging.
  • Splits ExpertOps positioning into offerings/expertops/messaging.md: who/problems/outcomes, operating model, partnership scope, scenarios, and evidence, without duplicating catalog tables.
  • Reorganizes offerings to mirror products/: expert-support/messaging.md, expert-consulting/messaging.md, and expertops/messaging.md plus service-catalog.md. Removes flat offerings/expert-*.md files.
  • Updates offerings/README.md with a Which offering? section (Support vs ExpertOps fork, Consulting, bundles, training) instead of a separate comparison page.
  • Adds inverse Support/ExpertOps one-liners in each offering messaging file; Consulting and solution-bundles note how offerings combine and that bundles are Consulting + Support, not ExpertOps.
  • Updates framework/why-percona.md, _sidebar.md, and automation/messaging-impact-map.yml for new paths.

Status: draft, not final

This PR is a starting point for review, not approved canonical messaging. @Andrey (and related commercial/delivery stakeholders) should review before we treat any of this as final, especially:

  • ExpertOps SLA and deliverable tables in service-catalog.md
  • Operational detail (access requirements, collaboration channels, onboarding checklist)
  • Whether this depth belongs in the messaging repo vs. another field reference layer now that Notion is going away

Open question: ExpertOps-only pattern

The service catalog split exists only under ExpertOps today. Expert Support and Expert Consulting still have positioning-only messaging.md files.

We need to discuss whether to:

  • Keep service catalogs ExpertOps-only (because it is the only ongoing operational subscription with this delivery model), or
  • Extend a similar messaging + service-catalog (or equivalent operational) pattern to other offerings or technology areas over time

Please use review comments to flag what should stay, move, or be cut before merge.

What we intentionally did not include

  • Pricing or quote examples from the deck
  • Unverified customer metrics (e.g. specific Atlas savings percentages)
  • Case studies without public Percona URLs
  • A standalone choosing-a-service page (portfolio guidance lives in README and offering cross-links)

Made with Cursor

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

Messaging Impact Check

  • Changed files: 9

offering-name-or-tier-change (WARN)

Offering naming updates should stay aligned across offering pages.

Required review files:

  • offerings/expert-support/messaging.md
  • offerings/expertops.md
  • offerings/expert-consulting/messaging.md
  • reference/canonical-naming.md
  • framework/core-positioning.md

Suggested additional scan:

  • products/**/messaging.md
  • use-cases-value-pillars/*.md

framework-story-touch (WARN)

Core framework story files usually need mutual consistency and may warrant aligned product or offering language.

Required review files:

  • framework/core-positioning.md
  • framework/why-percona.md
  • framework/executive-summary.md

Suggested additional scan:

  • offerings/*.md
  • use-cases-value-pillars/*.md
  • products/**/messaging.md

Manual waiver commands (maintainers):

  • /impact-ok all (optional same-line note after all is ignored)
  • /impact-all (same as /impact-ok all)
  • /impact-ok <exact missing path>
  • /impact-reset all
  • /impact-reset <exact missing path>

Waiver state is stored in <!-- messaging-impact-waiver-data:v1 -->.


Triggered by pull_request. Workflow impact-check.yml. Docs: AUTOMATION.md, automation/README.md.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

New File Governance Check

  • Added markdown files: 1
    • offerings/expertops/service-catalog.md

Missing or insufficient required sections:

  • Existing files reviewed first

  • Exact gap not covered by existing files

  • Why this must be a new canonical file

  • Owner and maintenance plan

  • Decomposition and propagation plan

Copy and paste the scaffold below into your PR body, then replace placeholders with specific details:

## New markdown file gate (required only when adding new `.md` files)

### Existing files reviewed first

- List the specific files you reviewed and what each one does.

### Exact gap not covered by existing files

- Explain what is still missing after reviewing existing canonical files.

### Why this must be a new canonical file

- State why editing an existing file is not sufficient.

### Owner and maintenance plan

- Name the owner and how this file will stay accurate over time.

### Decomposition and propagation plan

- List related files and downstream assets that may need updates.

Doc Coverage Check

  • New markdown docs: 1
  • Navigation docs scanned: 12
    • offerings/expertops/service-catalog.md (linked from: offerings/README.md)

All new docs are linked from repository navigation docs.

Duplicate Detector

  • Changed markdown docs: 6

No significant overlap detected.

Manual waiver commands (maintainers)

  • /governance-ok all or /governance-all
  • /governance-ok new-file, /governance-ok doc-coverage, /governance-ok duplicate
  • /governance-reset all or /governance-reset with the same token

Waiver JSON is stored in a hidden PR comment (messaging-governance-waiver-data:v1), same pattern as Impact Check.


Triggered by pull_request. Workflow content-governance-checks.yml. Docs: AUTOMATION.md, automation/README.md.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Jun 2, 2026

Messaging Smart Suggestions

File Why impacted Claim Confidence
offerings/expert-support/messaging.md Offering naming updates should stay aligned across offering pages. cost 0.65
offerings/expertops.md Offering naming updates should stay aligned across offering pages. cost 0.65
offerings/expert-consulting/messaging.md Offering naming updates should stay aligned across offering pages. cost 0.65
reference/canonical-naming.md Offering naming updates should stay aligned across offering pages. cost 0.95
framework/core-positioning.md Offering naming updates should stay aligned across offering pages. cost 0.95
framework/core-positioning.md Core framework story files usually need mutual consistency and may warrant aligned product or offering language. cost 0.95
framework/why-percona.md Core framework story files usually need mutual consistency and may warrant aligned product or offering language. cost 0.65
framework/executive-summary.md Core framework story files usually need mutual consistency and may warrant aligned product or offering language. cost 0.95

Only auto-apply suggestions at high confidence with reviewer approval.


Triggered by pull_request. Workflow smart-suggestions.yml. Docs: AUTOMATION.md, automation/README.md.

@brianamarie brianamarie force-pushed the expertops-service-catalog branch from 0720bb7 to fa0bcc7 Compare June 2, 2026 11:10
brianamarie and others added 2 commits June 2, 2026 13:13
…tories

Relocate expert-support and expert-consulting to offerings/<name>/messaging.md
to match the products/ layout. ExpertOps stays at offerings/expertops.md.
No content changes in this commit.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add ExpertOps service catalog (deliverables, SLAs, onboarding, access)
alongside expanded expertops.md positioning. Fold portfolio guidance into
offerings/README.md and inverse Support/ExpertOps lines into each messaging
file; clarify in solution-bundles that bundles are Consulting + Support, not
ExpertOps. Update sidebar, why-percona, and impact map paths.

Co-authored-by: Cursor <cursoragent@cursor.com>
Comment thread framework/why-percona.md
- **24×7×365 and clear SLAs:** 30 minutes for Severity-1 on Advanced Support and 15 minutes on Premium. Whether reactive during incidents or proactive through ExpertOps, Percona experts engage quickly and with deep technical accuracy across all supported technologies.
- **Optional personalized support:** For customers who need closer partnership, Percona offers named engineers, embedded communication channels, and regular operational reviews when included in the agreement. Experts aren't just available, we're actively present.
- **24×7×365 and clear SLAs:** 30 minutes for Severity-1 on Advanced Support and 15 minutes on Premium Support. ExpertOps subscriptions add hands-on operational ownership with tiered S1–S4 response targets and periodic reviews; see the [ExpertOps service catalog](../offerings/expertops/service-catalog.md).
- **Optional personalized support:** For customers who need closer partnership, Percona offers named Service Delivery Managers, embedded communication channels (including dedicated Slack and ticket portals), and regular operational reviews when included in the agreement. Experts aren't just available, we're actively present.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be better stylistically to replace in 'Experts aren't just available, we're actively present' with 'they're'?

- **Expert DBA hands-on support** for operational tasks within subscription hours
- **Named Service Delivery Manager (SDM)** for coordination, check-ins, customer advocacy, and regular operational reviews
- **Automated incident management** and defined escalation to Percona engineering when software defects or upstream issues require it
- **Root cause analysis (RCA)** for significant incidents, focused on durable fixes
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The challenge here is that we don't have a definition of 'significant', which might be problematic. Right now, RCA happens when our DBAs can't resolve an issue right away and need to do a deeper analysis.

| Cadence | Deliverables |
| --- | --- |
| **Real time** | Critical issue advisory, security patch guidance, known bug alerts for software in scope |
| **Weekly** | Health status summary, defined maintenance and minor upgrades within included hours |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

'Weekly' happens on the Premium tier only - not sure if that's important, but wanted to highlight it


## Service levels

| Severity | Advanced tier (initial response) | Premium tier (initial response) |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We now need to add Lite/Stable/Flex - and need to finalize naming :-) and its SLAs:
P1: 60 min
P2: 120 min
P3: 24 hours (weekdays)*
P4: 48 hours (weekdays)

| --- | --- | --- |
| **S1** | 30 minutes | 15 minutes |
| **S2** | 90 minutes | 60 minutes |
| **S3** | 24 hours (business days) | 4 hours |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we go with 'weekdays' instead of 'business days'

Copy link
Copy Markdown
Contributor

@andrey-glazkov andrey-glazkov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added several comments - please have a look

@brianamarie brianamarie added Content & messaging Canonical copy, products, use cases, case studies, and narrative. Area: Cross-product Legal, governance, CODEOWNERS, or work spanning multiple product paths. Needs: product or GTM Product, marketing, or GTM should confirm scope, naming, or positioning. labels Jun 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Area: Cross-product Legal, governance, CODEOWNERS, or work spanning multiple product paths. Content & messaging Canonical copy, products, use cases, case studies, and narrative. Needs: product or GTM Product, marketing, or GTM should confirm scope, naming, or positioning.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants