Skip to content

FF: restructure and edit#3312

Draft
kaitlynmichael wants to merge 5 commits into
mainfrom
DOC-6576
Draft

FF: restructure and edit#3312
kaitlynmichael wants to merge 5 commits into
mainfrom
DOC-6576

Conversation

@kaitlynmichael
Copy link
Copy Markdown
Contributor

@kaitlynmichael kaitlynmichael commented May 12, 2026

Note

Low Risk
Low-risk documentation-only restructure, but several new pages contain empty front matter (e.g., missing title/linkTitle) which could affect site navigation/build output.

Overview
Moves the provider/secret-provider/workspace CLI documentation out of streaming.md into new dedicated pages: a full register-providers.md guide and a smaller manage-workspace.md reference.

Adds several new FeatureForm docs stubs (concepts.md, configure-auth.md, define-and-deploy-features.md, query-data.md, reference.md, serve-features.md, update-features.md) that currently only include front matter placeholders, and leaves streaming.md effectively empty aside from its header.

Reviewed by Cursor Bugbot for commit b5c5666. Bugbot is set up for automated code reviews on this repo. Configure here.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 12, 2026

DOC-6576

@kaitlynmichael kaitlynmichael marked this pull request as draft May 12, 2026 17:51
@jit-ci
Copy link
Copy Markdown

jit-ci Bot commented May 12, 2026

🛡️ Jit Security Scan Results

CRITICAL HIGH MEDIUM

✅ No security findings were detected in this PR


Security scan by Jit

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 3 potential issues.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit b5c5666. Configure here.

---

Redis Feature Form supports multiple providers, secrets provider management, and workspaces.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Emptied page leaves stale title and broken link

Medium Severity

All body content was moved out of streaming.md to register-providers.md and manage-workspace.md, but the frontmatter still says title: Providers and workspaces and description: Build stream-backed features with Kafka, streaming transformations, and Redis serving.. This renders as an empty page with a misleading title in site navigation. Additionally, overview.md links to this file as "Connect providers" — that link now lands on a blank page. The frontmatter needs updating (or the file needs a redirect/removal).

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b5c5666. Configure here.

description:
linkTitle:
weight: 1
---
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Page with content has empty frontmatter fields

Medium Severity

manage-workspace.md contains real body content (workspace management commands moved from streaming.md) but its title, description, and linkTitle frontmatter fields are all blank. Unlike the other new placeholder files that are intentionally empty stubs, this page has substantive content. The missing frontmatter means it will render with no page title in navigation and no heading, and register-providers.md already links to it.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b5c5666. Configure here.


Before you register providers, make sure you have:

- A workspace. See [Manage workspaces](./manage-workspace.md) for the workspace lifecycle commands.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Raw markdown links instead of Hugo relref shortcodes

Medium Severity

The two cross-page links in register-providers.md use raw Markdown relative links (./manage-workspace.md, ./define-and-deploy-features.md) instead of Hugo relref shortcodes. Every other cross-page link in this project uses {{< relref "..." >}}, and there is no custom render-link.html hook in the layouts to rewrite .md paths to proper URLs. These links will be broken in the rendered site because Hugo will pass the .md href through as-is, which won't match the generated page URLs.

Additional Locations (1)
Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit b5c5666. Configure here.

Copy link
Copy Markdown
Collaborator

@dwdougherty dwdougherty left a comment

Choose a reason for hiding this comment

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

Apart from the issues already identified by Bugbot, LGTM.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants