Good-first-docs

Verification Required

Start with seeded docs issues.

Use these copy-ready starter issues for low-risk community contribution work. Each issue starts from a public route, names a bounded docs outcome, and keeps product claims at the existing maturity level.

Starter Summary

Seeded issues
15
Products covered
5
ObjectDB
3
Message Broker
3
Concordia
3
LogDB
3
Cross-product
3

Starter Boundaries

Start from public routes

Every starter issue names a public docs route. Employees may add source paths only after internal triage.

Keep scope low-risk

Good-first-docs issues focus on links, headings, scanability, glossary terms, example labels, and route discovery.

Preserve claim boundaries

Contributors should not strengthen product behavior, support, security, legal, durability, availability, scale, or performance claims.

Use the issue templates

Copy a starter issue, then use the DOCS-079 template fields when opening it in the approved tracker or support channel.

Seeded Issues

Good-first-docs issue seeds
IDTitleProductRouteReview routing
GFD-001Clarify ObjectDB quickstart cleanup wordingObjectDB/products/objectdb/quickstart/ObjectDB product SME and docs QA
GFD-002Add ObjectDB limits cross-links from S3 SDK examplesObjectDB/products/objectdb/guides/s3-sdk-examples/ObjectDB docs owner
GFD-003Improve ObjectDB evidence index scan labelsObjectDB/products/objectdb/evidence/ObjectDB product SME and docs lead
GFD-004Add Message Broker queue glossary cross-linksMessage Broker/products/message-broker/quickstart/Message Broker product SME
GFD-005Tighten Message Broker runbook evidence handoff copyMessage Broker/products/message-broker/operations/operator-runbooks/Support reviewer and Message Broker docs owner
GFD-006Add Message Broker SDK example labels for validation modeMessage Broker/products/message-broker/guides/rust-sdk-examples/Docs QA and Message Broker product SME
GFD-007Clarify Concordia local token languageConcordia/products/concordia/quickstart/Concordia product SME and security reviewer if wording changes
GFD-008Add Concordia validation runbook next-step linksConcordia/products/concordia/operations/validation-runbooks/Concordia docs owner
GFD-009Make Concordia local curl examples easier to skimConcordia/products/concordia/guides/local-curl-examples/Docs QA and Concordia product SME
GFD-010Clarify LogDB tenant header troubleshootingLogDB/products/logdb/quickstart/LogDB product SME
GFD-011Improve LogDB collector example expected-output labelsLogDB/products/logdb/guides/otel-collector-examples/Docs QA and LogDB docs owner
GFD-012Add LogDB limits links near S3 query-read wordingLogDB/products/logdb/reference/otlp-query/LogDB product SME and docs lead
GFD-013Add glossary terms for maturity and evidence languageCross-product/glossary/Docs lead
GFD-014Seed search synonyms for community starter tasksCross-product/search/Docs platform reviewer
GFD-015Add troubleshooting index links from support entry pointsCross-product/support/Support reviewer and docs lead

Copy Starter Issues

Paste a starter issue into the approved tracker or support intake, then add internal owner links during triage. Leave the public route and guardrail intact.

Text

GFD-001 Clarify ObjectDB quickstart cleanup wording

ObjectDB: Cleanup language tells readers what resource names are deleted, what success looks like, and which limits remain linked.

Docs issue type: Good-first-docs
Seed ID: GFD-001
Title: Clarify ObjectDB quickstart cleanup wording
Product: ObjectDB
Public route: /products/objectdb/quickstart/
Content type: quickstart
Labels: good-first-docs, product:objectdb, type:quickstart
Why this is good first: The work is wording-only and can be validated against the existing quickstart flow.
Expected docs outcome: Cleanup language tells readers what resource names are deleted, what success looks like, and which limits remain linked.
Review routing: ObjectDB product SME and docs QA
Guardrail: Do not change S3 Core support claims or add durability, availability, or AWS parity wording.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-002 Add ObjectDB limits cross-links from S3 SDK examples

ObjectDB: SDK examples make the unsupported S3 families easier to find before readers copy sample code.

Docs issue type: Good-first-docs
Seed ID: GFD-002
Title: Add ObjectDB limits cross-links from S3 SDK examples
Product: ObjectDB
Public route: /products/objectdb/guides/s3-sdk-examples/
Content type: guide
Labels: good-first-docs, product:objectdb, type:guide
Why this is good first: The change only adds nearby links to existing limits and compatibility pages.
Expected docs outcome: SDK examples make the unsupported S3 families easier to find before readers copy sample code.
Review routing: ObjectDB docs owner
Guardrail: Keep the examples illustrative unless docs QA accepts a stronger validation status.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-003 Improve ObjectDB evidence index scan labels

ObjectDB: Readers can distinguish route evidence, local adapter caveats, limits, examples, and operator runbooks at a glance.

Docs issue type: Good-first-docs
Seed ID: GFD-003
Title: Improve ObjectDB evidence index scan labels
Product: ObjectDB
Public route: /products/objectdb/evidence/
Content type: evidence
Labels: good-first-docs, product:objectdb, type:evidence
Why this is good first: The work is table-copy cleanup around existing evidence records.
Expected docs outcome: Readers can distinguish route evidence, local adapter caveats, limits, examples, and operator runbooks at a glance.
Review routing: ObjectDB product SME and docs lead
Guardrail: Do not mark pending evidence accepted or promote verification-required claims.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-004 Add Message Broker queue glossary cross-links

Message Broker: New readers can jump from queue-worker steps to the glossary and reference pages.

Docs issue type: Good-first-docs
Seed ID: GFD-004
Title: Add Message Broker queue glossary cross-links
Product: Message Broker
Public route: /products/message-broker/quickstart/
Content type: quickstart
Labels: good-first-docs, product:message-broker, type:quickstart
Why this is good first: The work links existing queue, cursor, replay, and worker terms without changing behavior.
Expected docs outcome: New readers can jump from queue-worker steps to the glossary and reference pages.
Review routing: Message Broker product SME
Guardrail: Do not imply Kafka wire compatibility or production replication guarantees.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-005 Tighten Message Broker runbook evidence handoff copy

Message Broker: The runbook names which route, status, tenant, stream, and redaction details belong in a support handoff.

Docs issue type: Good-first-docs
Seed ID: GFD-005
Title: Tighten Message Broker runbook evidence handoff copy
Product: Message Broker
Public route: /products/message-broker/operations/operator-runbooks/
Content type: runbook
Labels: good-first-docs, product:message-broker, type:runbook
Why this is good first: The change improves support-package wording while staying inside the current runbook evidence table.
Expected docs outcome: The runbook names which route, status, tenant, stream, and redaction details belong in a support handoff.
Review routing: Support reviewer and Message Broker docs owner
Guardrail: Do not add support response-time, SLA, failover, or cross-site durability promises.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-006 Add Message Broker SDK example labels for validation mode

Message Broker: Each example section makes compile/run status and reviewer-run rationale easier to scan.

Docs issue type: Good-first-docs
Seed ID: GFD-006
Title: Add Message Broker SDK example labels for validation mode
Product: Message Broker
Public route: /products/message-broker/guides/rust-sdk-examples/
Content type: guide
Labels: good-first-docs, product:message-broker, type:guide
Why this is good first: The page already separates example status; the issue asks for clearer labels and next-step links.
Expected docs outcome: Each example section makes compile/run status and reviewer-run rationale easier to scan.
Review routing: Docs QA and Message Broker product SME
Guardrail: Do not convert controlled-beta SDK examples into general production guidance.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-007 Clarify Concordia local token language

Concordia: Readers understand that local bearer tokens are development admission only and not production identity.

Docs issue type: Good-first-docs
Seed ID: GFD-007
Title: Clarify Concordia local token language
Product: Concordia
Public route: /products/concordia/quickstart/
Content type: quickstart
Labels: good-first-docs, product:concordia, type:quickstart
Why this is good first: The issue is a narrow wording pass around existing local bearer-token boundaries.
Expected docs outcome: Readers understand that local bearer tokens are development admission only and not production identity.
Review routing: Concordia product SME and security reviewer if wording changes
Guardrail: Do not add production JWT, identity-provider, or security assurance claims.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-008 Add Concordia validation runbook next-step links

Concordia: Validation failures route readers to the right Cache, Gateway, Storage, TSDB, or compatibility reference.

Docs issue type: Good-first-docs
Seed ID: GFD-008
Title: Add Concordia validation runbook next-step links
Product: Concordia
Public route: /products/concordia/operations/validation-runbooks/
Content type: runbook
Labels: good-first-docs, product:concordia, type:runbook
Why this is good first: The change adds existing reference, compatibility, and limits links to completed runbook sections.
Expected docs outcome: Validation failures route readers to the right Cache, Gateway, Storage, TSDB, or compatibility reference.
Review routing: Concordia docs owner
Guardrail: Do not treat validation-script acceptance as production runtime proof.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-009 Make Concordia local curl examples easier to skim

Concordia: Each curl example clearly names service, local-only maturity, expected result, and cleanup notes.

Docs issue type: Good-first-docs
Seed ID: GFD-009
Title: Make Concordia local curl examples easier to skim
Product: Concordia
Public route: /products/concordia/guides/local-curl-examples/
Content type: guide
Labels: good-first-docs, product:concordia, type:guide
Why this is good first: The work improves headings and expected-output scanability without changing commands.
Expected docs outcome: Each curl example clearly names service, local-only maturity, expected result, and cleanup notes.
Review routing: Docs QA and Concordia product SME
Guardrail: Keep Gateway alpha, local Cache, local Time Series, and Storage validation boundaries visible.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-010 Clarify LogDB tenant header troubleshooting

LogDB: Readers can tell when `x-logdb-tenant` and OTLP resource tenant attributes disagree.

Docs issue type: Good-first-docs
Seed ID: GFD-010
Title: Clarify LogDB tenant header troubleshooting
Product: LogDB
Public route: /products/logdb/quickstart/
Content type: quickstart
Labels: good-first-docs, product:logdb, type:quickstart
Why this is good first: The issue improves one common troubleshooting path already documented in the quickstart.
Expected docs outcome: Readers can tell when `x-logdb-tenant` and OTLP resource tenant attributes disagree.
Review routing: LogDB product SME
Guardrail: Do not add multi-tenant isolation, compliance, or external auth guarantees.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-011 Improve LogDB collector example expected-output labels

LogDB: Collector and curl examples make ingest, query, tenant header, and cleanup expectations easier to compare.

Docs issue type: Good-first-docs
Seed ID: GFD-011
Title: Improve LogDB collector example expected-output labels
Product: LogDB
Public route: /products/logdb/guides/otel-collector-examples/
Content type: guide
Labels: good-first-docs, product:logdb, type:guide
Why this is good first: The page already has examples; this issue asks for clearer section labels and validation notes.
Expected docs outcome: Collector and curl examples make ingest, query, tenant header, and cleanup expectations easier to compare.
Review routing: Docs QA and LogDB docs owner
Guardrail: Keep local-dev policy warnings and live-route boundaries visible.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-012 Add LogDB limits links near S3 query-read wording

LogDB: Readers understand the difference between retained segment query, S3 query-read, BYOC notes, and future live S3 publication.

Docs issue type: Good-first-docs
Seed ID: GFD-012
Title: Add LogDB limits links near S3 query-read wording
Product: LogDB
Public route: /products/logdb/reference/otlp-query/
Content type: reference
Labels: good-first-docs, product:logdb, type:reference
Why this is good first: The work links existing limits and compatibility rows from current S3 query-read copy.
Expected docs outcome: Readers understand the difference between retained segment query, S3 query-read, BYOC notes, and future live S3 publication.
Review routing: LogDB product SME and docs lead
Guardrail: Do not imply S3-backed publication or BYOC availability beyond the current status labels.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-013 Add glossary terms for maturity and evidence language

Cross-product: Glossary entries help readers distinguish Live, Controlled Beta, Preview Contract, Future, and Verification Required language.

Docs issue type: Good-first-docs
Seed ID: GFD-013
Title: Add glossary terms for maturity and evidence language
Product: Cross-product
Public route: /glossary/
Content type: glossary
Labels: good-first-docs, product:cross-product, type:glossary
Why this is good first: The issue adds or tightens definitions without changing product-specific behavior.
Expected docs outcome: Glossary entries help readers distinguish Live, Controlled Beta, Preview Contract, Future, and Verification Required language.
Review routing: Docs lead
Guardrail: Keep definitions aligned with the maturity label source of truth.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-014 Seed search synonyms for community starter tasks

Cross-product: Searches for starter issue, good first docs, missing docs, and contribution help return the Community routes.

Docs issue type: Good-first-docs
Seed ID: GFD-014
Title: Seed search synonyms for community starter tasks
Product: Cross-product
Public route: /search/
Content type: search
Labels: good-first-docs, product:cross-product, type:search
Why this is good first: The issue is a low-risk search-index keyword update tied to existing public routes.
Expected docs outcome: Searches for starter issue, good first docs, missing docs, and contribution help return the Community routes.
Review routing: Docs platform reviewer
Guardrail: Do not add hidden routes, private tracker names, or source-edit workflow keywords.
Sensitive details removed: yes
Private source paths needed before triage: no

Text

GFD-015 Add troubleshooting index links from support entry points

Cross-product: Readers with docs gaps, operational symptoms, or support evidence questions can choose the right next route.

Docs issue type: Good-first-docs
Seed ID: GFD-015
Title: Add troubleshooting index links from support entry points
Product: Cross-product
Public route: /support/
Content type: operations
Labels: good-first-docs, product:cross-product, type:support
Why this is good first: The work adds links between existing support, troubleshooting, and privacy-safe handoff pages.
Expected docs outcome: Readers with docs gaps, operational symptoms, or support evidence questions can choose the right next route.
Review routing: Support reviewer and docs lead
Guardrail: Do not add support SLA, escalation-time, or product bug intake promises.
Sensitive details removed: yes
Private source paths needed before triage: no