Skip to content

Conversation

@flossypurse
Copy link
Contributor

Summary

Comprehensive documentation for the Python countdown example demonstrating durable sleep.

Changes

Documentation Added

  • Problem/Solution: Clear explanation of why durable sleep matters
  • Use Cases: Real-world applications (reminders, SLA monitors, rate limiting)
  • How It Works: Step-by-step walkthrough with code annotations
  • Crash Recovery: Explains what happens when process dies during sleep
  • Running Instructions: Complete setup and usage guide
  • Configuration: Multiple notification backends (ntfy.sh, Slack, Discord)
  • Testing: Procedures to verify crash recovery behavior
  • Serverless: GCP Functions deployment guide
  • Key Concepts: Durable sleep, idempotency, resource efficiency

Metadata

  • Added GitHub topics: resonate, python, durable-execution, countdown, notifications
  • Updated repository description

Why This Matters

The countdown example is perfect for demonstrating durable sleep - a core Resonate feature that enables:

  • Long-running workflows without resource consumption
  • Crash-resistant timers and schedulers
  • Serverless functions that exceed execution limits

This README makes it easy for developers to understand and run the example.

Testing

Example already has working code. README provides clear instructions for:

  1. Basic countdown execution
  2. Crash recovery testing
  3. Long-running countdown (24+ hours)
  4. GCP Functions deployment

Added comprehensive documentation for the Python countdown example:

**Content Added:**
- Problem statement (resource waste, crash recovery)
- Solution explanation (durable sleep benefits)
- Real-world use cases (reminders, SLA monitors, rate limiting)
- Step-by-step code walkthrough
- Crash recovery explanation
- Running instructions with example commands
- Configuration options (ntfy.sh, Slack, Discord)
- Failure scenario testing procedures
- Key concepts (durable sleep, idempotency, resource efficiency)
- Production considerations
- Related examples

**Structure:**
- Clear sections with progressive detail
- Code examples with explanations
- Testing procedures for crash recovery
- Multiple notification backend examples

Updated repo description and topics: resonate, python, durable-execution,
countdown, notifications

Note: Removed serverless/cloud function sections as Python SDK does not
yet have shims for those platforms.

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
@flossypurse flossypurse force-pushed the feature/enhance-countdown-py-readme branch from dd0ea35 to 305a0cd Compare January 27, 2026 20:58
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.

2 participants