How-to guides

Task-focused guides (prereqs → steps → verify) for integrating, operating, and tuning RecSys.

Who this is for

• Engineers integrating RecSys into an application
• Operators running the suite in production and on-call

What you will get

• Goal-oriented steps (prereqs → steps → verify)
• Operational runbooks for common failure modes

Common tasks

• Integrate serving API
  Tenancy, auth, request/response, and production integration notes.
• Integration checklist
  A compact “did we do the basics?” list for app teams.
• Troubleshooting for integrators
  Symptom → cause → fix checklist for empty recs, auth issues, and join problems.
• Run eval & ship decisions
  Produce reports and decide ship/hold/rollback with evidence.
• Validate logging & joinability
  Confirm exposures and outcomes are attributable before you trust metrics.
• Tune ranking safely
  Change ranking behavior without losing auditability or rollback discipline.
• Add a signal end-to-end
  Extend ranking inputs safely and validate the impact.
• Deploy with Helm
  Kubernetes deployment guide and production checks.
• Operations
  Production readiness, performance, and on-call runbooks.

Read next

• Tutorials (happy-path walkthroughs): Tutorials
• Reference (contracts + config): Reference
• Explanation (mental model): Explanation