Overview
Guides provide practical, experience-based recommendations for building and operating applications on RVO.
Unlike the reference documentation, guides focus on real-world usage, operational patterns, and production considerations.
Where guides are published
Section titled “Where guides are published”At the moment, RVO guides are published on the blog rather than directly in the documentation.
This allows guides to:
- Evolve over time
- Include longer explanations and context
- Cover operational experience and trade-offs
- Be shared and announced as standalone articles
The documentation remains focused on current, supported platform behavior, while guides capture applied knowledge and best practices.
What guides cover
Section titled “What guides cover”Guides may include topics such as:
- Production-ready client configuration
- Retry and backoff strategies
- Scaling RPC usage safely
- Separating environments and workloads
- Monitoring and diagnosing RPC behavior
- Migration and upgrade considerations
These guides complement the reference documentation and are written for teams running real workloads.
Finding guides
Section titled “Finding guides”All published guides are available on the RVO blog:
As new guides are written, they may be linked directly from this section.
Future documentation integration
Section titled “Future documentation integration”Over time, selected guides may be:
- Summarized in the documentation
- Linked from relevant reference pages
- Converted into first-class docs when they describe stable patterns
This allows the documentation to remain concise while still providing access to deeper operational knowledge.
When to use guides vs docs
Section titled “When to use guides vs docs”Use the documentation when you need:
- Exact behavior
- API reference
- Authentication and limit semantics
Use guides when you want:
- Practical recommendations
- Operational insight
- Examples drawn from real usage
Both are part of the same system, serving different purposes.