You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
docs(cookbook): add missing values strategy and imputation cookbook guide #513
As identified in the Growth & Developer Onboarding Audit, developers searching for practical solutions like "how to handle missing values pandas" or "safe tabular imputation" benefit from problem-oriented cookbook recipes in docs/cookbook/.
Task
Create a new problem-oriented cookbook guide in docs/cookbook/imputation-strategies-guide.md illustrating how FreshData approaches missing value imputation safely:
Explain the difference between simple univariate imputation (mean, median, mode) vs iterative model-based imputation (missforest).
Show how to configure per-column imputation rules vs global strategy.
Demonstrate FreshData's safety guarantees (e.g. refusal to impute declared ID or target columns).
Show how to inspect the generated CleanReport audit log to see exactly which rows and columns were modified.
Register the new recipe under the Cookbook section in mkdocs.yml.
Acceptance Criteria
Create docs/cookbook/imputation-strategies-guide.md with complete markdown explanations and runnable Python examples.
Document parameter combinations (strategy="conservative" vs "balanced" vs "aggressive", impute=...).
Add the page to the nav list in mkdocs.yml under Cookbook.
Verify that documentation builds cleanly without broken links using mkdocs build --strict.
I’m preparing the requested imputation-strategies cookbook with executed examples for global/per-column rules, declared ID and target protection, MissForest model/fallback behavior, and audit inspection. I’ll document the current report granularity accurately and verify the strict docs build.
Activity
WilliamK112 commentedon Oct 13, 2026
/assign
I’m preparing the requested imputation-strategies cookbook with executed examples for global/per-column rules, declared ID and target protection, MissForest model/fallback behavior, and audit inspection. I’ll document the current report granularity accurately and verify the strict docs build.
github-actions commentedon Oct 13, 2026
Hey @WilliamK112! 🎉 You have claimed this issue.
Quick Onboarding Checklist
pytest tests/<test_file>.py --no-cov(bypasses CI 93% global gate during local development).ruff check .(Need to unassign yourself? Simply reply with
/unassign.)