Skip to content

Conversation

@agents-git-bot
Copy link
Contributor

@agents-git-bot agents-git-bot bot commented Jan 2, 2026

Summary

Add comprehensive documentation for the new file watching feature that enables real-time filesystem monitoring using Linux's native inotify system.

This documentation sync is for PR cloudflare/sandbox-sdk#324 which adds file watching capabilities to the Sandbox SDK.

Changes

  • API Reference (/sandbox/api/file-watching/): Complete documentation for sandbox.watch() method, WatchHandle interface, and all related types
  • Comprehensive Guide (/sandbox/guides/file-watching/): Real-world examples and patterns for:
    • Development tools and hot-reload systems
    • Testing automation and CI/CD
    • File processing and batch operations
    • Asset pipelines and image processing
    • Configuration management
    • Advanced patterns (debouncing, error handling, batch processing)
  • API Index Update: Added file watching to the main API reference navigation

Key Features Documented

  • Real-time monitoring using Linux's native inotify system
  • Event filtering with include/exclude glob patterns
  • Multiple event types: create, modify, delete, rename
  • Resource management with proper cleanup patterns
  • Error handling and resilience strategies
  • Performance optimization best practices

Use Cases Covered

  • Hot-reload development servers
  • Automated testing systems
  • File processing pipelines
  • Asset optimization workflows
  • Configuration monitoring
  • Build automation

Related PR

The documentation follows Cloudflare docs style guidelines and includes comprehensive TypeScript examples using the TypeScriptExample component.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 2, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/r2/ @oxyjun, @elithrar, @jonesphillip, @aninibread, @harshil1712, @cloudflare/workers-docs, @cloudflare/pcx-technical-writing
/src/content/docs/sandbox/ @whoiskatrin, @ghostwriternr, @cloudflare/pcx-technical-writing, @cloudflare/ai-agents
/src/content/partials/workers/ @cloudflare/workers-docs, @GregBrimble, @irvinebroque, @mikenomitch, @WalshyDev, @cloudflare/deploy-config, @cloudflare/pcx-technical-writing, @cloudflare/wrangler, @mattietk

@agents-git-bot agents-git-bot bot force-pushed the sync-docs-pr-324 branch 2 times, most recently from 0e13a53 to b417ee8 Compare January 3, 2026 11:33
@agents-git-bot agents-git-bot bot force-pushed the sync-docs-pr-324 branch 3 times, most recently from 3807636 to f038623 Compare January 14, 2026 17:33
@agents-git-bot agents-git-bot bot changed the title feat: add file watching capabilities with inotify support docs: add file watching capabilities with inotify support Jan 14, 2026
- Add API reference for file watching with watch() method documentation
- Add comprehensive how-to guide for file watching workflows including hot reloading, test automation, and file synchronization
- Update API index to include file watching section

This documentation covers the new file watching capabilities with inotify support added in cloudflare/sandbox-sdk PR #324.
@agents-git-bot agents-git-bot bot changed the title docs: add file watching capabilities with inotify support feat: add file watching capabilities with inotify support Jan 14, 2026
github-actions bot and others added 4 commits January 14, 2026 20:25
Adds comprehensive documentation for the new file watching feature:

- Documents watch() method with inotify-based filesystem monitoring
- Covers event types (create, modify, delete, rename)
- Explains WatchHandle interface and lifecycle management
- Provides filtering examples with include/exclude patterns
- Includes real-world use cases (hot reload, test runners, config monitoring)
- Documents performance considerations and error handling
- Updates API index page to include watching documentation

Syncs with feat: add file watching capabilities with inotify support (sandbox-sdk PR #324)
- Add comprehensive API reference for file watching methods (watch, watchStream, stopWatch, listWatches)
- Add detailed how-to guide covering basic usage, hot reloading, build integration, config monitoring
- Include TypeScript examples, performance considerations, and best practices
- Update main overview page with file watching feature highlight and example tab
- Add file watching to API index navigation

Relates to cloudflare/sandbox-sdk PR #324
Add comprehensive documentation for the new file watching feature:

- API reference documentation with methods, types, and examples
- How-to guide covering development tools and automation workflows
- Integration with existing API reference navigation
- Real-world examples for auto-reload, builds, and responsive dev tools
* Update deleting-data.mdx

* added wrangler version to snapshot expiration

* removed broken link

until wrangler 4.56 is released

* updated wrangler version

updated wrangler version and added working references to wrangler commands.

* corrected a note about snapshot expiration

* Remove package.json and package-lock.json changes

* Update src/content/docs/r2/data-catalog/deleting-data.mdx

Co-authored-by: Jun Lee <[email protected]>

---------

Co-authored-by: Jun Lee <[email protected]>
@github-actions
Copy link
Contributor

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

@asmaylsydbdalzym808-sketch
Copy link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants