update Testream documentation

Author: hasanalituran

docs/intro.md

@@ -1,12 +1,18 @@
 ---
 sidebar_position: 1
+title: Introduction
+description: Learn how Testream sends automated test results from CI/CD into Jira with reporters, CTRF uploads, artifacts, and release visibility.
+keywords:
+  - jira test reporting docs
+  - automated test reporting jira
+  - ci cd test results jira
 ---
 
 # Introduction
 
 Welcome to **Testream**, code-first automated test reporting for Jira teams.
 
-Testream brings automated test evidence from your codebase and CI/CD pipeline into Jira, without requiring teams to recreate every automated test as a manual Jira test case.
+Testream brings automated test results from CI/CD into Jira so teams can review pass rate, failures, artifacts, branch and commit context, suite changes, and release readiness without creating a separate manual test-case layer.
 
 ## What is Testream?
 

docs/reporters/cli.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 6
+title: 'CLI Reporter'
+description: 'Upload CTRF test reports to Testream and Jira from GitHub Actions, CircleCI, Bitbucket Pipelines, Jenkins, GitLab, or any custom CI.'
+keywords:
+  - ctrf upload jira
+  - cli test reporting jira
+  - upload test results to jira from ci
 ---
 
 # CLI Reporter
 
-Upload CTRF test reports to Testream from any CI provider using the CLI.
+Upload CTRF test reports to Testream from any CI provider with the CLI, then review the results in Jira with branch, commit, build, environment, and artifact context.
+
+If you are evaluating the product path first, start with the website page for [CI/CD test results in Jira](https://testream.app/ci-test-results-jira).
 
 ## What you need
 

docs/reporters/cypress.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 3
+title: 'Cypress Reporter'
+description: 'Send Cypress test results, screenshots, videos, and end-to-end artifacts into Jira with the Testream Cypress Reporter.'
+keywords:
+  - cypress jira reporter
+  - cypress test reporting jira
+  - cypress component testing jira
 ---
 
 # Cypress Reporter
 
-The Testream Cypress Reporter runs your Cypress tests and automatically uploads test results to Testream. You can use it as a CLI tool or integrate it directly into your Cypress configuration.
+Use the Testream Cypress Reporter to send Cypress test results, screenshots, videos, and CI/CD run context into Testream and Jira.
+
+Looking for the commercial overview first? Read the website page for [Cypress Jira integration](https://testream.app/cypress-jira-integration).
 
 ## Installation
 
@@ -25,7 +33,7 @@ npx @testream/cypress-reporter -k $TESTREAM_API_KEY
 This single command will:
 
 1. Run your Cypress tests
-2. Generate a CTRF report automatically
+2. Prepare uploadable results automatically
 3. Upload results to Testream (project key inferred from API key)
 
 ### Option 2: Programmatic Configuration

docs/reporters/dotnet.md

@@ -1,10 +1,20 @@
 ---
 sidebar_position: 2
+title: '.NET Reporter'
+description: 'Send xUnit, NUnit, MSTest, and TRX-based test results from CI/CD into Jira with the Testream .NET Reporter.'
+keywords:
+  - dotnet jira reporter
+  - xunit jira reporting
+  - nunit jira reporting
+  - mstest jira reporting
+  - trx jira reporting
 ---
 
 # .NET Reporter
 
-The Testream .NET Reporter runs your tests (or reads existing TRX files), converts results to CTRF, and uploads them to Testream.
+Use the Testream .NET Reporter to send xUnit, NUnit, MSTest, and TRX-based test results from CI/CD into Testream and Jira.
+
+Looking for the higher-level product fit first? Read the website page for [.NET Jira integration](https://testream.app/dotnet-jira-integration).
 
 ## Installation
 
@@ -25,7 +35,7 @@ npx @testream/dotnet-reporter -k $TESTREAM_API_KEY
 This single command will:
 
 1. Run `dotnet test`
-2. Generate a CTRF report
+2. Convert the results automatically
 3. Upload to Testream (project key inferred from API key)
 
 ## CLI Options

docs/reporters/jest.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 4
+title: 'Jest Reporter'
+description: 'Send Jest test results from CI/CD into Jira with the Testream Jest Reporter and review failures and trends in Testream.'
+keywords:
+  - jest jira reporter
+  - jest test reporting jira
+  - jest ci results jira
 ---
 
 # Jest Reporter
 
-The Testream Jest Reporter generates and uploads Jest test results to Testream from your existing Jest configuration.
+Use the Testream Jest Reporter to send Jest unit and integration test results from CI/CD into Testream and Jira.
+
+Looking for the higher-level product fit first? Read the website page for [Jest Jira integration](https://testream.app/jest-jira-integration).
 
 ## Installation
 

docs/reporters/junit.md

@@ -1,10 +1,19 @@
 ---
 sidebar_position: 7
+title: 'JUnit Reporter'
+description: 'Upload JUnit XML test results from Java CI/CD pipelines into Jira with the Testream JUnit Reporter.'
+keywords:
+  - junit jira reporter
+  - java junit jira
+  - maven surefire jira reporting
+  - gradle junit jira
 ---
 
 # JUnit Reporter
 
-The Testream JUnit Reporter converts JUnit XML into a CTRF report and uploads the results to Testream.
+Use the Testream JUnit Reporter to convert JUnit XML output from CI/CD and send Java test results into Testream and Jira.
+
+Looking for the commercial overview first? Read the website page for [JUnit Jira integration](https://testream.app/junit-jira-integration).
 
 ## Installation
 

docs/reporters/mocha.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 9
+title: 'Mocha Reporter'
+description: 'Send Mocha test results from CI/CD into Jira with the Testream Mocha Reporter and built-in upload support.'
+keywords:
+  - mocha jira reporter
+  - mocha test reporting jira
+  - node mocha jira
 ---
 
 # Mocha Reporter
 
-The Testream Mocha Reporter generates CTRF test reports from Mocha and uploads them to Testream.
+Use the Testream Mocha Reporter to send Mocha test results from CI/CD into Testream and Jira with built-in upload support.
+
+Looking for the commercial overview first? Read the website page for [Mocha Jira integration](https://testream.app/mocha-jira-integration).
 
 ## Installation
 

docs/reporters/playwright.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 1
+title: 'Playwright Reporter'
+description: 'Send Playwright test results, traces, screenshots, and videos into Jira with the Testream Playwright Reporter.'
+keywords:
+  - playwright jira reporter
+  - playwright test reporting jira
+  - playwright ci results jira
 ---
 
 # Playwright Reporter
 
-The Testream Playwright Reporter generates CTRF reports and uploads test results (plus artifacts) to Testream.
+Use the Testream Playwright Reporter to send Playwright test results, screenshots, videos, and traces into Testream and Jira.
+
+Looking for the commercial overview first? Read the website page for [Playwright Jira integration](https://testream.app/playwright-jira-integration).
 
 ## Installation
 

docs/reporters/pytest.md

@@ -1,10 +1,19 @@
 ---
 sidebar_position: 10
+title: 'Pytest Reporter'
+description: 'Send Pytest and JUnit-based Python test results from CI/CD into Jira with the Testream Pytest Reporter.'
+keywords:
+  - pytest jira reporter
+  - python pytest jira
+  - django pytest jira
+  - fastapi pytest jira
 ---
 
 # Pytest Reporter
 
-The Testream Pytest Reporter runs your Pytest suite (or ingests existing JUnit XML), converts results to CTRF, and uploads them to Testream.
+Use the Testream Pytest Reporter to send Pytest and JUnit-based Python test results from CI/CD into Testream and Jira.
+
+Looking for the commercial overview first? Read the website page for [Pytest Jira integration](https://testream.app/pytest-jira-integration).
 
 ## Installation
 
@@ -26,7 +35,7 @@ This single command will:
 
 1. Run `pytest`
 2. Write JUnit XML to `junit/pytest-junit.xml`
-3. Convert to CTRF and upload to Testream
+3. Convert the results automatically and upload to Testream
 
 For a full end-to-end repository example (project layout, intentional failures, and CI setup), see the **Sample Project** section below.
 

docs/reporters/vitest.md

@@ -1,10 +1,18 @@
 ---
 sidebar_position: 8
+title: 'Vitest Reporter'
+description: 'Send Vitest test results from CI/CD into Jira with the Testream Vitest Reporter and run metadata.'
+keywords:
+  - vitest jira reporter
+  - vitest test reporting jira
+  - vitest ci results jira
 ---
 
 # Vitest Reporter
 
-The Testream Vitest Reporter generates a CTRF report from your Vitest test run and uploads the results to Testream.
+Use the Testream Vitest Reporter to send Vitest test results from CI/CD into Testream and Jira with run metadata and CI-friendly uploads.
+
+Looking for the broader use case? Read the website page for [Vitest Jira integration](https://testream.app/vitest-jira-integration).
 
 ## Installation