docs: update readme with respect information (#2143)

* docs: update readme with respect information

* docs: update readme with respect information

* docs: update readme with respect information

Author: Marshevskyy

README.md

@@ -101,6 +101,37 @@ The `stylish` output is as good as it sounds, but if you need JSON, Markdown, Ch
 
 [Learn more about API standards and configuring Redocly rules](https://redocly.com/docs/cli/api-standards).
 
+### API contract testing with Respect
+
+Ensure your APIs match their OpenAPI descriptions with **Respect**, Redocly's API contract testing system. Respect sends real HTTP requests to your API server and validates that responses match the expectations defined in your OpenAPI description and Arazzo workflows.
+
+- Verify API responses match your OpenAPI schema
+- Test complex API sequences using OpenAPI Arazzo format
+- Catch API drift early in development and CI/CD
+- Ensure external APIs you depend on behave as expected
+- Track response times and detect anomalies
+
+#### Quick start
+
+```sh
+# Generate test workflows from your OpenAPI spec
+redocly generate-arazzo openapi.yaml
+
+# Run contract tests against your API
+redocly respect auto-generated.arazzo.yaml --verbose
+```
+
+#### Respect vs. Respect Monitoring
+
+Respect is Redocly's community-edition product. Looking for something more? We also offer continuous API monitoring with additional features including:
+
+- Real-time insights
+- Automated alerts via email or Slack
+- Automated API checks
+- Proactive API quality assurance
+
+Learn more about [Respect](https://redocly.com/respect) and [get started with API contract testing](https://redocly.com/docs/respect/get-started).
+
 ### Transform an OpenAPI description
 
 If your OpenAPI description isn't everything you hoped it would be, enhance it with the Redocly [decorators](https://redocly.com/docs/cli/decorators) feature.

packages/respect-core/README.md

@@ -6,12 +6,25 @@ Continuous API monitoring powered by OpenAPI Arazzo workflows.
 
 This package cannot be used standalone. Please install and use [@redocly/cli](https://github.com/Redocly/redocly-cli) to run API tests.
 
-The key benefits of `respect`:
+## What is Respect?
 
-- Increases clarity and readability of tests.
-- Autogenerates tests from OpenAPI to get started quickly.
-- Maintain a positive reputation in your ecosystem (nobody likes when a 3rd party API change breaks their own software).
-- Efficient because it links API requests to corresponding OpenAPI descriptions automatically.
-- Shift left to catch problems fast before they are costly. Run on developer laptops and CICD.
+Respect is Redocly's API contract testing system that validates your APIs match their OpenAPI descriptions. It sends real HTTP requests to your API server and compares responses against the expectations defined in your OpenAPI specification and Arazzo workflows.
 
-You **MUST** have a working API server running in order to run the tests because it sends real HTTP requests.
+- Write tests in human-readable Arazzo format
+- Get started quickly with auto-generated test workflows
+- Catch API drift before it breaks your ecosystem
+- Links API requests to OpenAPI descriptions automatically
+- Catch problems early in development and CI/CD pipelines
+
+## Requirements
+
+You **MUST** have a working API server running in order to run the tests because Respect sends real HTTP requests.
+
+## Documentation and resources
+
+- [Respect documentation](https://redocly.com/docs/respect)
+- [Getting started guide](https://redocly.com/docs/respect/get-started)
+- [Use cases](https://redocly.com/docs/respect/use-cases)
+- [Arazzo workflow testing](https://redocly.com/docs/respect/guides/test-api-sequences)
+- [Command reference](https://redocly.com/docs/respect/commands/respect)
+- [Respect CLI overview](https://redocly.com/respect-cli)