Skip to content

docs: fix configuration.md ConfigValue references#137

Merged
zeevdr merged 1 commit into
mainfrom
fix/134-configuration-doc-configvalue
Jun 7, 2026
Merged

docs: fix configuration.md ConfigValue references#137
zeevdr merged 1 commit into
mainfrom
fix/134-configuration-doc-configvalue

Conversation

@zeevdr

@zeevdr zeevdr commented Jun 7, 2026

Copy link
Copy Markdown
Member

Summary

  • The Return types section of configuration.md documented a ConfigValue dataclass (with field_path, value, checksum, description fields) that does not exist in the package — importing it raises an ImportError.
  • Replace it with the real third dataclass, ServerVersion (version, commit), and clarify that get_all() returns a plain dict[str, str] mapping field paths to their string values rather than a dataclass.

Test plan

  • Verified ServerVersion's actual fields against sdk/src/opendecree/types.py
  • Verified get_all()'s actual return type (dict[str, str]) against sdk/src/opendecree/client.py
  • Ran the repo's pre-commit checklist (docs-only diff short-circuits to safety scan only)

Closes #134

The Return types section documented a ConfigValue dataclass (with
field_path, value, checksum, description fields) that does not exist
in the package, causing an ImportError for anyone trying to import it.

Replace it with the real third dataclass, ServerVersion (version,
commit), and clarify that get_all() returns a plain dict[str, str]
mapping field paths to their string values rather than a dataclass.

Closes #134
@zeevdr zeevdr added this to the Beta Readiness milestone Jun 7, 2026
@zeevdr zeevdr added size: S Quick win — a few hours or less priority: P0 Blocks alpha or release labels Jun 7, 2026
@codecov

codecov Bot commented Jun 7, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@zeevdr zeevdr merged commit d9ef07c into main Jun 7, 2026
12 checks passed
@zeevdr zeevdr deleted the fix/134-configuration-doc-configvalue branch June 7, 2026 12:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

priority: P0 Blocks alpha or release size: S Quick win — a few hours or less

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: configuration.md documents non-existent ConfigValue class

1 participant