FF: restructure and edit#3312
Conversation
🛡️ Jit Security Scan Results
✅ No security findings were detected in this PR
Security scan by Jit
|
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 3 potential issues.
❌ 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. | ||
|
|
There was a problem hiding this comment.
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).
Reviewed by Cursor Bugbot for commit b5c5666. Configure here.
| description: | ||
| linkTitle: | ||
| weight: 1 | ||
| --- |
There was a problem hiding this comment.
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.
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. |
There was a problem hiding this comment.
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)
Reviewed by Cursor Bugbot for commit b5c5666. Configure here.
dwdougherty
left a comment
dwdougherty
left a comment
There was a problem hiding this comment.
Apart from the issues already identified by Bugbot, LGTM.
|
|
||
| ### Workspace state to remember | ||
|
|
||
| - workspaces have unique names and descriptions |
There was a problem hiding this comment.
Nit: A reading of this phrase could be "both names and descriptions are unique across namespaces" so I might suggest "workspaces have unique names and optional descriptions".
| weight: 30 | ||
| --- | ||
|
|
||
| Register the providers and secret backends a Redis Feature Form workspace needs before you author features or transformations. Providers connect the workspace to external systems for storage, compute, serving, or catalog-backed access, and definitions files reference them by name. |
There was a problem hiding this comment.
Not: Is it necessary to qualify "workspace" with "Redis Feature Form"?
| - Any environment variables your provider commands reference set **in the Feature Form server's environment**, not in your shell. | ||
| - For example, `--pg-password-secret env:PG_PASSWORD` makes the server resolve `PG_PASSWORD` from its own process environment at runtime. For Helm-based deployments, set these through chart values; for binary deployments, export them where the server starts. |
There was a problem hiding this comment.
It would be helpful to use the domain name "secret provider" and mention that a default env secret provider is created along with each workspace. The env secret provider is an environment variable type secret provider; however, users may required another type (e.g. Hashicorp Vault, Kubernetes secrets, or AWS Secrets Manager).
| **Best practice:** keep the default health check on. Registration surfaces connectivity and secret-resolution problems at the point you can fix them, rather than as silent failures during materialization or serving. Reserve `--skip-health-check` for cases where you've already validated the provider through another channel. | ||
| {{< /note >}} | ||
|
|
||
| ## Register Postgres for offline storage |
There was a problem hiding this comment.
"... as offline provider" might align more closely with Feature Form's domain vocabulary
3 participants
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.mdinto new dedicated pages: a fullregister-providers.mdguide and a smallermanage-workspace.mdreference.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 leavesstreaming.mdeffectively 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.