Skip to content

Add Korvet documentation (latest) - #3868

Draft
joshrotenberg wants to merge 4 commits into
mainfrom
korvet-docs
Draft

Add Korvet documentation (latest)#3868
joshrotenberg wants to merge 4 commits into
mainfrom
korvet-docs

Conversation

@joshrotenberg

@joshrotenberg joshrotenberg commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

What

Adds documentation for Korvet, the Kafka-compatible streaming service backed by Redis Streams from Redis Field Engineering, under content/integrate/korvet/ — modeled on the Redis Data Integration subtree.

This is a ~1:1 port of the existing Antora site (https://redis-field-engineering.github.io/korvet/, release 0.19) to Hugo Markdown: format conversion only (frontmatter, relrefs, shortcodes, fenced code blocks); prose is carried over verbatim. Editorial/house-style passes come as follow-ups once this lands.

Scope

  • Product landing page plus six sections: Get Started, Concepts & Architecture, Using the Kafka API, Tiered Storage, Operations, Reference — 44 pages, ~8,300 lines
  • Two architecture SVGs under static/images/korvet/
  • Not ported (stays in the korvet repo, per the migration plan): the "Under the Hood" internals section (reference/design/*); the 9 links to it are de-linked (link text kept as plain text)
  • No version picker wiring in this PR — this is the latest version only. Versioned folders and the selector can follow (cc @paololazzari, per our Slack thread)

Porting notes

  • {github-url} resolves to https://github.com/redis-field-engineering/korvet-dist (the public distribution repo), matching the current Antora site
  • The Antora version banner on the landing page was dropped (redundant with redis.io versioning)
  • Two pages move position to match the published nav: features/schema-registrykafka-api/schema-registry, admin-apioperations/admin-api
  • The generated configuration reference (91 properties) is snapshotted inline in reference/configuration.md, exactly as the published Configuration page renders it; the standalone orphan page that Antora included was not carried over. Emitting this reference as Markdown from the Korvet build is a planned follow-up
  • Metrics partials are inlined into their pages (verified same metric counts as source)
  • Open item for reviewers: should Korvet get its own docset entry in data/doc_bundles.json (the documentation-download widget), like RDI and RedisVL? Its pages are already included in the whole-integrate bundle
  • Known stale anchor carried over from the source: reference/faq.md links to storage/redis-streams#value-mapper-selection, which no longer exists on the target page in 0.19

Plan

  • Skeleton: product _index.md, reference section index, images
  • Port: Get Started, Concepts
  • Port: Kafka API, Tiered Storage
  • Port: Operations
  • Port: Reference (configuration, API, metrics, FAQ)
  • Link/lint validation pass (file inventory, AsciiDoc-leftover lint, relref resolution, image refs, balanced shortcodes)

Tracked in redis-field-engineering/korvet#1472.

Korvet is a Kafka-compatible streaming service backed by Redis Streams,
developed by Redis Field Engineering. This adds the product landing page,
the reference section index, and the two architecture images, as the
skeleton for a 1:1 port of the existing Korvet docs (release 0.19) from
redis-field-engineering.github.io/korvet.
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

🧠 Redis Memory

Found 7 related items from repository history:

Memory updated at 2608df4

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Staging links:
https://redis.io/docs/staging/korvet-docs/integrate/korvet/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/concepts/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/compatibility/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/consume/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/databricks/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/produce/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/schema-registry/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/kafka-api/topics/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/admin-api/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/authentication/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/benchmarks/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/deployment/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/kubernetes/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/logging/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/migration/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/monitoring/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/production-tuning/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/resilience/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/troubleshooting/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/operations/web-ui/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/configuration/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/demo/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/docker/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/hello-world/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/quick-start/install/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/reference/
https://redis.io/docs/staging/korvet-docs/integrate/korvet/reference/api/

1:1 format port of the published Korvet docs (release 0.19) from
Antora/AsciiDoc to Hugo Markdown: Get Started, Concepts & Architecture,
Using the Kafka API, Tiered Storage, Operations, and Reference
(configuration, API, metrics, FAQ). Prose is carried over verbatim;
only syntax changed (frontmatter, relrefs, admonition shortcodes,
fenced code blocks, Markdown tables, inlined metrics partials).

Not ported, per the migration plan: the 'Under the Hood' internals
section (stays in the korvet repo); links to it are de-linked. The
standalone generated configuration page is folded into the
Configuration reference page, matching the published nav.
Every section _index.md in an integrate product tree carries
type: integration, group, and summary (see the RDI subtree) so nested
section pages do not fall through to the integrate card-grid template,
which requires a non-nil group on child sections and fails the build
otherwise (integrate/list.html: index of $labelColors with nil).
The theme renders the description above the body, and the body's first
line is the same sentence; the RDI landing page uses a null description
for the same reason.
@mich-elle-luna mich-elle-luna self-assigned this Aug 28, 2026
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.

3 participants