Collector docs improved (#27)

Author: sridharswain

docs/cookbooks/batch-evaluation.mdx

@@ -441,6 +441,8 @@ def find_failures(results: List[EvalTask]) -> List[Dict]:
 
 ### Generating Reports
 
+> **Tip:** For pytest-based batch runs, you can use the built-in `--fe-output` flag to export results as JSON or HTML without writing custom reporting code. See [Output Collectors](/docs/advanced/output-collectors) for details.
+
 ```python
 # reporting.py
 import json

docs/core-concepts/pytest.mdx

@@ -9,6 +9,8 @@ sidebar:
     anchor: running-tests
   - title: Understanding Output
     anchor: understanding-output
+  - title: Exporting Results
+    anchor: exporting-results
   - title: Fixtures
     anchor: fixtures
   - title: CI/CD Integration
@@ -74,6 +76,23 @@ Evaluation Results:
     be perceived as unhelpful or rude.
 ```
 
+### Exporting Results
+
+You can export evaluation results to JSON or HTML, or print a summary table to the console:
+
+```bash
+# Export as JSON
+pytest tests/ --fe-output json:results.json
+
+# Export as HTML report
+pytest tests/ --fe-output html:report.html
+
+# Print a summary table after the run
+pytest tests/ --fe-summary
+```
+
+For full details on output formats, custom reporters, and programmatic access, see [Output Collectors](/docs/advanced/output-collectors).
+
 ## Configuration
 
 ### Using pyproject.toml (Recommended)
@@ -202,7 +221,14 @@ jobs:
       - name: Run evaluations
         env:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-        run: pytest tests/ -v --tb=short
+        run: pytest tests/ -v --tb=short --fe-output json:results.json --fe-summary
+
+      - name: Upload results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: evaluation-results
+          path: results.json
 ```
 
 ### Separating Fast and Slow Tests

docs/getting-started/quickstart.mdx

@@ -229,4 +229,5 @@ You've got the fundamentals down. Here's where to go deeper:
 - **Evaluate RAG pipelines** — [RAG Metrics](/docs/rag-metrics/faithfulness)
 - **Build custom metrics** — [Custom Metrics](/docs/advanced/custom-metrics)
 - **Set up CI/CD** — [CI/CD Setup](/docs/cookbooks/ci-cd-setup)
+- **Export results** — [Output Collectors](/docs/advanced/output-collectors) for JSON, HTML reports, and custom formats
 - **Monitor production** — [fasteval-observe](/docs/plugins/observe/overview)