Context
As outlined in the Contributor Roadmap, documentation should clearly explain how out-of-core execution errors behave when users configure strict execution policies.
Task
Expand docs/fallback-matrix.md with explicit Python code examples showing how fd.FallbackError is raised when fallback_policy="error" is triggered, and how users can programmatically catch and inspect the exception attributes.
Acceptance Criteria
Pointers
- Target documentation file:
docs/fallback-matrix.md
- Exception implementation: search for
class FallbackError in src/freshdata/
New to the codebase? Comment here and we'll help you get set up! You can also check our First Contribution Guide.
Context
As outlined in the Contributor Roadmap, documentation should clearly explain how out-of-core execution errors behave when users configure strict execution policies.
Task
Expand
docs/fallback-matrix.mdwith explicit Python code examples showing howfd.FallbackErroris raised whenfallback_policy="error"is triggered, and how users can programmatically catch and inspect the exception attributes.Acceptance Criteria
docs/fallback-matrix.mdunder thefallback_policy="error"section.try ... except fd.FallbackError as err:demonstrating how to inspect exception properties (e.g.err.trigger,err.backend).mkdocs build --strict.Pointers
docs/fallback-matrix.mdclass FallbackErrorinsrc/freshdata/New to the codebase? Comment here and we'll help you get set up! You can also check our First Contribution Guide.