Skip to content

update featureform docs#50

Merged
davidwtf merged 1 commit intomainfrom
update-featureform-docs
Sep 4, 2025
Merged

update featureform docs#50
davidwtf merged 1 commit intomainfrom
update-featureform-docs

Conversation

@davidwtf
Copy link
Copy Markdown
Contributor

@davidwtf davidwtf commented Sep 4, 2025

Summary by CodeRabbit

  • Documentation
    • Updated installation instructions to reference the latest tarball and corresponding push command.
    • Added a new section on configuring Dashboard authentication (Basic auth) with example configuration.
    • Expanded FAQ:
      • Added guidance for resolving a UTF-8 error caused by SDK/server version mismatch (upgrade recommended).
      • Added troubleshooting for jobs stuck in PENDING due to coordinator restarts, with remediation steps.
    • Pinned Quickstart requirements to an exact Featureform version for consistency.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Sep 4, 2025

Walkthrough

Documentation updates adjust the installation tarball name and command example, add a dashboard Basic Auth configuration section, insert and renumber FAQ entries (including new UTF-8 mismatch and PENDING/etcd rotation items), and pin the quickstart requirements to featureform==1.12.1.

Changes

Cohort / File(s) Summary
Docs: Installation and command updates
docs/en/solutions/How_to_Install_and_use_Featureform.md
Updated tarball filename to featureform.amd64.v0.12.1-2.tgz and revised the example violet push command accordingly.
Docs: Dashboard auth config
docs/en/solutions/How_to_Install_and_use_Featureform.md
Added a section with YAML showing how to enable Basic authentication for the Dashboard with default credentials.
Docs: FAQ reorganization and additions
docs/en/solutions/How_to_Install_and_use_Featureform.md
Inserted new FAQ about UTF-8 error from SDK/server version mismatch; renumbered subsequent items; added FAQ about PENDING status due to etcd token rotation with update/apply guidance.
Quickstart requirements pin
docs/public/featureform/quickstart/requirements.txt
Pinned dependency from featureform>=1.12.1 to featureform==1.12.1.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I twitch my whiskers at versioned skies,
New tarballs hop, and FAQs revise.
A password burrow guards the dash,
UTF-8 gremlins—shoo! we flash.
PENDING? Etcd’s token spun—
Pin the path, and off we run. 🐇✨

✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch update-featureform-docs

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

🧹 Nitpick comments (2)
docs/en/solutions/How_to_Install_and_use_Featureform.md (2)

198-203: Verify tarball name and add checksum step

Confirm featureform.amd64.v0.12.1-2.tgz exists in the release repo; add a checksum verification so users catch corrupted downloads.

Example addition:

 Download the Featureform installation file: `featureform.amd64.v0.12.1-2.tgz`
+
+Optionally verify checksum:
+```bash
+sha256sum featureform.amd64.v0.12.1-2.tgz
+# Expected: <paste official sha256>
+```

734-741: FAQ formatting: add code-fence languages, fix list indentation, and drop trailing colons in headings

These lines trigger markdownlint (MD040, MD007, MD026). Apply the pattern below across all FAQ items.

Example for the first item:

-### 1. Error when executing apply:
+### 1. Error when executing apply

-  ```
+```text
   "UNKNOWN:Error received from peer  {grpc_message:"grpc: error unmarshalling request: string field contains invalid UTF-8", grpc_status:13"
-  ```
+```

-  - **Cause**: Featureform SDK version doesn't match the server version
-  - **Solution**: Update Featureform SDK version to 1.21.1
+- **Cause**: Featureform SDK version doesn't match the server version
+- **Solution**: Update Featureform SDK version to <chosen-version>

Apply the same:

  • Use “```text” for error snippets.
  • Remove trailing “:” in FAQ headings.
  • Unindent list items to start at column 0.

Also applies to: 750-757, 758-765, 766-773, 774-781, 782-789, 790-797, 798-802

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between e8c159f and 306bf30.

📒 Files selected for processing (2)
  • docs/en/solutions/How_to_Install_and_use_Featureform.md (3 hunks)
  • docs/public/featureform/quickstart/requirements.txt (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/en/solutions/How_to_Install_and_use_Featureform.md

[grammar] ~771-~771: There might be a mistake here.
Context: ...`` - Cause: Redis is incorrectly using Sentinel access address - *Solution...

(QB_NEW_EN)


[grammar] ~772-~772: There might be a mistake here.
Context: ...ntinel access address - Solution: Replace Redis instance or update Redis access a...

(QB_NEW_EN)


[grammar] ~772-~772: There might be a mistake here.
Context: ...Solution: Replace Redis instance or update Redis access address ### 6. After appl...

(QB_NEW_EN)

🪛 markdownlint-cli2 (0.17.2)
docs/en/solutions/How_to_Install_and_use_Featureform.md

734-734: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


738-738: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


739-739: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


742-742: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


743-743: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


747-747: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


748-748: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


750-750: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


751-751: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


755-755: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


756-756: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


758-758: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


759-759: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


763-763: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


764-764: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


766-766: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


767-767: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


771-771: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


772-772: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


774-774: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


775-775: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


779-779: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


780-780: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


782-782: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


783-783: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


787-787: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


788-788: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


790-790: Trailing punctuation in heading
Punctuation: ':'

(MD026, no-trailing-punctuation)


791-791: Fenced code blocks should have a language specified

(MD040, fenced-code-language)


795-795: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


796-796: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


800-800: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)


801-801: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)

Comment on lines +341 to +354
### 3. Configuring Dashboard Authentication

#### 3.1 Enabling Ingress Authentication

Add the following configuration to enable Basic authentication for the Dashboard. The default username and password are both `featureform`.

```yaml
ingress:
auth:
enabled: true
username: featureform # Optional, default username is featureform
password: featureform # Optional, default password is featureform
```

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.

🛠️ Refactor suggestion

Avoid documenting default prod credentials; use placeholders and add a warning

Publishing hardcoded defaults encourages insecure deployments. Replace with placeholders and add a warning note.

-#### 3.1 Enabling Ingress Authentication
+#### 3.1 Enabling Ingress Authentication
+
+> Warning: Do not use default credentials in production. Set strong, unique values (or configure an existing secret) before exposing the dashboard.

   ```yaml
   ingress:
     auth:
       enabled: true
-      username: featureform # Optional, default username is featureform
-      password: featureform # Optional, default password is featureform
+      username: CHANGE_ME_USERNAME
+      password: CHANGE_ME_PASSWORD
If the chart supports referencing a secret (e.g., `secretName`), prefer that over inline credentials.

<details>
<summary>🤖 Prompt for AI Agents</summary>

In docs/en/solutions/How_to_Install_and_use_Featureform.md around lines 341 to
354, the docs currently show hardcoded default production credentials
(featureform/featureform); replace those values with clear placeholders like
CHANGE_ME_USERNAME and CHANGE_ME_PASSWORD, add a short warning note instructing
users to change credentials before production, and, if the Helm chart supports
it, prefer and document referencing a Kubernetes secret (e.g., secretName)
instead of inline credentials to avoid embedding secrets in values files.


</details>

<!-- fingerprinting:phantom:triton:chinchilla -->

<!-- This is an auto-generated comment by CodeRabbit -->

Comment on lines +739 to +740
- **Solution**: Update Featureform SDK version to 1.21.1

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.

⚠️ Potential issue

SDK version here conflicts with Quickstart pin; resolve the source of truth

This says “Update Featureform SDK version to 1.21.1” while quickstart pins 1.12.1. Confirm the correct version that fixes the UTF‑8 mismatch and align both places.

Proposed fix if staying on 1.12.1:

-  - **Solution**: Update Featureform SDK version to 1.21.1
+  - **Solution**: Update Featureform SDK version to 1.12.1

Alternatively, if 1.21.1 is required, bump docs/public/featureform/quickstart/requirements.txt accordingly (see companion comment).

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Solution**: Update Featureform SDK version to 1.21.1
- **Solution**: Update Featureform SDK version to 1.12.1
🧰 Tools
🪛 markdownlint-cli2 (0.17.2)

739-739: Unordered list indentation
Expected: 0; Actual: 2

(MD007, ul-indent)

🤖 Prompt for AI Agents
In docs/en/solutions/How_to_Install_and_use_Featureform.md around lines 739-740,
the SDK version "Update Featureform SDK version to 1.21.1" conflicts with the
quickstart pin at 1.12.1; decide which version actually fixes the UTF-8 mismatch
and make both places match: if you keep 1.12.1, change this line to 1.12.1 and
note the config/patch that fixes UTF-8; if 1.21.1 is required, update
docs/public/featureform/quickstart/requirements.txt to pin 1.21.1 and update any
mention in the quickstart; ensure both files reflect the same chosen version and
run a quick local verification that the UTF-8 issue is resolved.

@@ -1,2 +1,2 @@
psycopg2-binary>=2.9.0
featureform>=1.12.1
featureform==1.12.1
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.

💡 Verification agent

🧩 Analysis chain

Version pin conflicts with FAQ; align SDK version across docs

Quickstart pins featureform==1.12.1, but the FAQ instructs upgrading the SDK to 1.21.1. Pick one supported version and make both files consistent to avoid user breakage.

Two possible fixes (choose one and apply repo-wide):

- featureform==1.12.1
+ featureform==1.21.1

or keep 1.12.1 and change the FAQ solution line accordingly (see comment in How_to_Install_and_use_Featureform.md).
Run to locate remaining mismatches:


🏁 Script executed:

#!/bin/bash
rg -nP '(featureform\s*==\s*\d+\.\d+\.\d+|Featureform SDK version.*\d+\.\d+\.\d+)' -g '!**/dist/**' -g '!**/build/**'

Length of output: 312


Align SDK version across docs
Update docs/public/featureform/quickstart/requirements.txt (line 2) to match the FAQ’s recommendation in docs/en/solutions/How_to_Install_and_use_Featureform.md:

- featureform==1.12.1
+ featureform==1.21.1
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
featureform==1.12.1
++ docs/public/featureform/quickstart/requirements.txt
@@ -1,3 +1,3 @@
featureform==1.12.1
featureform==1.21.1
🤖 Prompt for AI Agents
In docs/public/featureform/quickstart/requirements.txt around line 2, the pinned
featureform version (featureform==1.12.1) is inconsistent with the FAQ
recommendation in docs/en/solutions/How_to_Install_and_use_Featureform.md;
update the version specifier on line 2 to exactly match the version recommended
in that FAQ (replace 1.12.1 with the FAQ’s recommended version) so the docs are
aligned.

@davidwtf davidwtf merged commit ce9039e into main Sep 4, 2025
2 checks passed
@davidwtf davidwtf deleted the update-featureform-docs branch September 4, 2025 07:30
This was referenced Sep 10, 2025
changluyi pushed a commit to changluyi/knowledge that referenced this pull request Apr 23, 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.

1 participant