Visitar URL original
docs: Clarify CLI options and configuration output by Hanabi9249 · Pull Request #6966 · feast-dev/feast · GitHub
Skip to content

docs: Clarify CLI options and configuration output - #6966

Open
Hanabi9249 wants to merge 1 commit into
feast-dev:masterfrom
Hanabi9249:codex/docs-cli-reference-accuracy
Open

Hanabi9249 wants to merge 1 commit into
feast-dev:masterfrom
Hanabi9249:codex/docs-cli-reference-accuracy

Conversation

@Hanabi9249

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:

The CLI reference omits the existing YAML file-selection and logging options and does not explain that feast configuration omits unset fields. This can leave users unclear about which configuration file is selected or why an effective default is absent from the output.

Document the global options, their placement and configuration-path precedence. Clarify the configuration dump's default-field limitations and label the YAML example as an excerpt. Only the CLI reference Markdown changes; runtime behavior is unchanged.

Validation: combined patch applies cleanly on master 9d42729d471a611597760284e3feaf61e000ca0c; git diff --cached --check passes. The option and serialization contracts were checked against the unchanged CLI/RepoConfig source, and the YAML example was parsed in the original documentation verification. CLI execution, Python tests and the Sphinx build were not run; the local environment lacks Feast/pyarrow, and no dependencies were installed for this documentation change.

Open #6903 edits the Global Options introduction for structured output. It addresses a different behavior, but that introduction may need a small textual conflict resolution if it lands first.

Which issue(s) this PR fixes:

No linked issue.

Checks

  • I've made sure the tests are passing.
  • My commits are signed off (git commit -s)
  • My PR title follows conventional commits format.

Testing Strategy

  • Unit tests
  • Integration tests
  • Manual tests
  • Testing is not required for this change

Release notes

NONE

Signed-off-by: Hanabi <3666353208@qq.com>
@Hanabi9249
Hanabi9249 requested a review from a team as a code owner October 7, 2026 22:48

Copy link
Copy Markdown
Contributor Author

Could a CLI maintainer review the configuration-path precedence and the explanation of fields omitted by feast configuration? The wording follows the existing option handling and exclude_unset serialization, without changing runtime behavior. #6903 touches the same Global Options introduction for a separate feature; I can resolve that small text overlap if it lands first. DCO is green, while the integration checks are skipped. Validation here is limited to the source contracts, YAML parsing and patch checks; CLI execution and a Sphinx build have not been run.

This branch has not been deployed

No deployments
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