feat: initialize Docusaurus website with configuration, documentation, and styling

Author: tsutomi

.gitignore

@@ -420,5 +420,11 @@ FodyWeavers.xsd
 .idea
 samples/**/src/**/appsettings.local.json
 
+# Docusaurus website
+website/node_modules/
+website/build/
+website/.docusaurus/
+website/.cache-loader/
+
 # macOS
 .DS_Store

RELEASE_NOTES.md

@@ -0,0 +1,55 @@
+# v1.1.2 — OpenTelemetry
+
+**Release date:** 2026-06-09
+
+## Summary
+
+OpenTelemetry instrumentation is now a first-class citizen in Ratatosk. This release introduces a new package `Ratatosk.Extensions.OpenTelemetry` along with comprehensive tracing and metrics support across the client facade, the connectors layer, and each individual channel connector.
+
+## New Package
+
+- **`Ratatosk.Extensions.OpenTelemetry`** — Convenience extensions for wiring up Ratatosk's telemetry sources into OpenTelemetry. Provides `AddRatatoskInstrumentation()` methods on `TracerProviderBuilder` and `MeterProviderBuilder`, and a `WithOpenTelemetry()` shortcut on `MessagingBuilder`.
+
+## Tracing (ActivitySources)
+
+- `Ratatosk.Client` — spans from the `IMessagingClient` facade covering send, receive, and status operations.
+- `Ratatosk.Connector.*` — per-connector spans (Twilio, SendGrid, Firebase, Facebook, Telegram) for fine-grained observability.
+
+## Metrics (Meters)
+
+- `Ratatosk.Client` — client-level counters and histograms (sent count, send duration, etc.).
+- `Ratatosk.Connector.*` — per-connector metrics (sent/received/failed counts, latency histograms).
+- New `ConnectorMeter` utility class for consistent meter naming across connectors.
+
+## New Request Classes
+
+- `SendRequest`, `ReceiveRequest`, `ReceiveStatusRequest`, `StatusRequest`, `BatchSendRequest` — strongly-typed request objects that carry operation parameters and telemetry context, enabling richer activity tracking.
+
+## Telemetry Infrastructure
+
+- `ClientTelemetry` — centralized telemetry coordination for the messaging client.
+- `ConnectorTelemetry` — per-connector telemetry implementation handling activities and metrics.
+- `MessagingSemanticConventions` — semantic convention constants for messaging attributes (messaging system, destination name, operation type, etc.).
+- `MessageContext` — context object for attaching trace information to message delivery.
+
+## Other
+
+- `ChannelConnectorBase` refactored to integrate with new telemetry infrastructure.
+- `MessagingClient` significantly refactored to leverage request classes and centralized telemetry.
+- New test projects: OpenTelemetry extension tests, connector telemetry tests.
+- New documentation: `docs/telemetry.md` — comprehensive telemetry guide.
+- Updated `ROADMAP.md` and `README.md`.
+- Solution file updated to include the new package.
+
+## Full Changelog
+
+```
+eb200be feat: add OpenTelemetry support for tracing and metrics in Ratatosk framework
+ef97672 feat: add ConnectorMeter utility for consistent meter naming in telemetry
+88b3c91 feat: enhance telemetry metrics with message count and improve activity scope management
+7f1b2e4 feat: enhance telemetry with additional messaging attributes and improve activity tracking
+9a39bf6 feat: enhance telemetry metrics for message sending, receiving, and status queries
+4b9af24 feat: introduce request classes for messaging operations and enhance telemetry context handling
+```
+
+**Files changed:** 36 files, +3,089 / −681

docs/README.md

@@ -1,11 +1,15 @@
+---
+slug: /
+---
+
 [![NuGet](https://img.shields.io/nuget/v/Ratatosk.Abstractions.svg?label=NuGet)](https://www.nuget.org/packages/Ratatosk.Abstractions/)
 [![codecov](https://codecov.io/gh/deveel/ratatosk/graph/badge.svg)](https://codecov.io/gh/deveel/ratatosk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/deveel/ratatosk/blob/main/LICENSE)
 [![.NET](https://img.shields.io/badge/.NET-8.0%20%7C%209.0%20%7C%2010.0-512BD4)](https://dotnet.microsoft.com/)
 [![Documentation](https://img.shields.io/badge/docs-available-blue)](https://ratatosk.deveel.org)
 
 <p align="center">
-  <img src="ratatosk-full-logo.png" alt="Ratatosk" width="400"/>
+  <img src="/img/ratatosk-full-logo.png" alt="Ratatosk" width="400"/>
 </p>
 
 # Ratatosk
@@ -89,7 +93,7 @@ The framework is deliberately focused on the messaging contract and connector co
 - [Senders](senders/README.md) - sender identity guides and navigation hub
 - [Sender management](senders/sender-management.md) - sender identity model, registry lifecycle, storage options, and governance
 - [Sender resolution](senders/sender-resolution.md) - runtime sender lookup, fallback behavior, cache, and diagnostics
-- [IMessagingClient facade](quickstart.md#6-imessagingclient-facade) — high-level client with lazy initialization and named channel routing
+- [IMessagingClient facade](quickstart.md#5-advanced-resolution-strategies) — high-level client with lazy initialization and named channel routing
 
 **Building and wiring:**
 

docs/installation.md

@@ -59,7 +59,7 @@ builder.Services
 
 `AddMessaging()` returns a `MessagingBuilder` instance. Each `AddConnector<T>()` call registers the connector as a singleton in DI and also registers the connector's schema in the `IChannelSchemaRegistry`. Connectors are resolved as `IChannelConnector` from DI.
 
-Call `.AddClient()` on the builder to register the `IMessagingClient` facade, which handles lazy connector initialization and channel routing (see [Quickstart](quickstart.md#6-imessagingclient-facade)).
+Call `.AddClient()` on the builder to register the `IMessagingClient` facade, which handles lazy connector initialization and channel routing (see [Quickstart](quickstart.md#5-advanced-resolution-strategies)).
 
 ### What AddMessaging registers
 

docs/roadmap.md

@@ -0,0 +1,40 @@
+# Roadmap
+
+The project roadmap is tracked in the repository root as [ROADMAP.md](https://github.com/deveel/ratatosk/blob/main/ROADMAP.md).
+
+## Summary
+
+### v0.4.0 — Framework Foundations ✓
+Strengthens quality gates, release automation, observability, and docs completeness.
+
+### v0.5.0 — Inbound Messaging ✓
+Completes the receive-side model for bidirectional messaging.
+
+### v1.0.0 — First Stable Release ✓
+Locks the public API and ships stable NuGet packages.
+
+### v1.1.0 — Resilience & Observability
+Retry/circuit-breaker policies, OpenTelemetry signals, health checks, timeout controls.
+
+### v1.2.0 — New SaaS Connectors
+Slack, Microsoft Teams, WhatsApp Business API, Viber, LINE.
+
+### v1.3.0 — Protocol Connectors
+SMPP, SMTP, RCS, APNs (direct).
+
+### v1.4.0 — Content Adaptation & Transcoding
+IContentTranscoder, built-in transcoders, SMS segmentation.
+
+### v1.5.0 — Address & Number Validation
+E.164 normalization, HLR lookup, email validation.
+
+### v1.6.0 — Tooling & Instrumentation
+dotnet new connector scaffold, diagnostic middleware.
+
+### v2.0.0 — Conversations
+First-class conversation management with multi-channel support.
+
+### v2.1.0 — Message Templates
+Provider-agnostic template model with local and server-side rendering.
+
+For the full milestone-level detail, rationale, and dependency information, see [ROADMAP.md](https://github.com/deveel/ratatosk/blob/main/ROADMAP.md).

website/.gitignore

@@ -0,0 +1,20 @@
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

website/README.md

@@ -0,0 +1,41 @@
+# Website
+
+This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+
+## Installation
+
+```bash
+yarn
+```
+
+## Local Development
+
+```bash
+yarn start
+```
+
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+
+## Build
+
+```bash
+yarn build
+```
+
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
+
+## Deployment
+
+Using SSH:
+
+```bash
+USE_SSH=true yarn deploy
+```
+
+Not using SSH:
+
+```bash
+GIT_USER=<Your GitHub username> yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

website/docsearch.json

@@ -0,0 +1,16 @@
+{
+  "index_name": "ratatosk",
+  "start_urls": ["https://ratatosk.deveel.org/docs/"],
+  "sitemap_urls": ["https://ratatosk.deveel.org/sitemap.xml"],
+  "selectors": {
+    "lvl0": {
+      "selector": "",
+      "default_value": "Documentation"
+    },
+    "lvl1": "header h1",
+    "lvl2": "article h2",
+    "lvl3": "article h3",
+    "lvl4": "article h4",
+    "text": "article p, article li, article td"
+  }
+}