Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

API Documentation (rustdoc)

The complete API documentation is generated from Rust source code and is available separately.

Viewing API Documentation

Online

Visit the API Reference section of the documentation site.

Locally

Build and view the API documentation:

# Build API docs
cargo doc --no-deps --all-features

# Open in browser
cargo doc --no-deps --all-features --open

Or build the complete documentation (user guide + API):

make docs-serve
# Navigate to http://localhost:3000/rustdoc/bindy/index.html

What’s in the API Documentation

The rustdoc API documentation includes:

  • Module Documentation - All public modules and their organization
  • Struct Definitions - Complete CRD type definitions (Bind9Instance, DNSZone, etc.)
  • Function Signatures - All public functions with parameter types and return values
  • Examples - Code examples showing how to use the API
  • Type Documentation - Detailed information about all public types
  • Trait Implementations - All trait implementations for types

Key Modules

  • bindy::crd - Custom Resource Definitions
  • bindy::reconcilers - Controller reconciliation logic
  • bindy::bind9 - BIND9 zone file management
  • bindy::bind9_resources - Kubernetes resource builders

When the documentation is built, you can access:

  • Main API Index: rustdoc/bindy/index.html
  • CRD Module: rustdoc/bindy/crd/index.html
  • Reconcilers: rustdoc/bindy/reconcilers/index.html