reformat build & run commands. Add link to upstream vLLM docs

Author: saichandrapandraju

README.md

@@ -17,18 +17,33 @@ At the moment, the following detectors are supported:
 
 ## Building
 
-* `huggingface`: podman build -f detectors/Dockerfile.hf detectors
-* `llm_judge`: podman build -f detectors/Dockerfile.judge detectors
-* `builtIn`: podman build -f detectors/Dockerfile.builtIn detectors
+To build the detector images, use the following commands:
+
+| Detector | Build Command |
+|----------|---------------|
+| `huggingface` | `podman build -t $TAG -f detectors/Dockerfile.hf detectors` |
+| `llm_judge` | `podman build -t $TAG -f detectors/Dockerfile.judge detectors` |
+| `builtIn` | `podman build -t $TAG -f detectors/Dockerfile.builtIn detectors` |
+
+Replace `$TAG` with your desired image tag (e.g., `my-detector:latest`).
+
 
 ## Running locally
-* `builtIn`: podman run -p 8080:8080 $BUILT_IN_IMAGE
 
-## Examples
+### Quick Start Commands
+
+| Detector | Run Command | Notes |
+|----------|-------------|-------|
+| `builtIn` | `podman run -p 8080:8080 $BUILT_IN_IMAGE` | Ready to use |
+| `huggingface` | `podman run -p 8000:8000 -e MODEL_DIR=/mnt/models/$MODEL_NAME -v $MODEL_PATH:/mnt/models/$MODEL_NAME:Z $HF_IMAGE` | Requires model download |
+| `llm_judge` | `podman run -p 8000:8000 -e VLLM_BASE_URL=$LLM_SERVER_URL $LLM_JUDGE_IMAGE` | Requires OpenAI-compatible LLM server |
+
+
+### Detailed Setup Instructions & Examples
 
-- Check out [built-in detector examples](docs/builtin_examples.md) to see how to use the built-in detectors for file type validation and personally identifiable information (PII) detection
-- Check out [Hugging Face detector examples](docs/hf_examples.md) to see how to use the Hugging Face detectors for detecting toxic content and prompt injection
-- Check out [LLM Judge detector examples](docs/llm_judge_examples.md) to see how to use any OpenAI API compatible LLM for content assessment with built-in metrics and custom natural-language criteria
+- **Built-in detector**: No additional setup required. Check out [built-in detector examples](docs/builtin_examples.md) to see how to use the built-in detectors for file type validation and personally identifiable information (PII) detection
+- **Hugging Face detector**: Check out [Hugging Face detector examples](docs/hf_examples.md) for a complete setup and examples on how to use the Hugging Face detectors for detecting toxic content and prompt injection
+- **LLM Judge detector**: Check out [LLM Judge detector examples](docs/llm_judge_examples.md) for a complete setup and examples on how to use any OpenAI API compatible LLM for content assessment with built-in metrics and custom natural-language criteria
 
 ## API
 See [IBM Detector API](https://foundation-model-stack.github.io/fms-guardrails-orchestrator/?urls.primaryName=Detector+API)

docs/llm_judge_examples.md

@@ -4,7 +4,7 @@ The LLM Judge detector integrates [vLLM Judge](https://github.com/trustyai-expla
 
 ### Local Setup
 
-1. **Start an OpenAI-compatible LLM server** (example with vLLM):
+1. **Start an OpenAI-compatible LLM server** (example with [vLLM](https://docs.vllm.ai/en/stable/serving/openai_compatible_server.html)):
 ```bash
 vllm serve Qwen/Qwen2.5-7B-Instruct --port 9090
 ```