simplify index page with concise intro and code examples

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: snopoke

docs/index.md

@@ -1,31 +1,63 @@
-# Welcome to Task Badger Documentation
+# Task Badger Documentation
 
-Task Badger is a specialized monitoring system designed to provide deep visibility into your background jobs and asynchronous tasks. While it doesn't handle task execution itself, Task Badger seamlessly integrates with popular task processing systems like Celery to give developers comprehensive insights into their task operations. With Task Badger, you can track task progress, analyze performance patterns, and debug issues across your distributed task processing infrastructure. Whether you're managing a small set of periodic jobs or orchestrating complex distributed workflows, Task Badger offers the monitoring and observability tools you need to ensure your tasks are running smoothly.
+Task Badger is a monitoring and observability platform for background jobs and async tasks. It integrates with task processing systems like Celery to give you visibility into task progress, performance, and failures.
 
 ![Task Badger](assets/visualization.png)
 
-## Key Features
+## Get Started
+
+Install the Python SDK:
+
+```bash
+pip install taskbadger
+```
+
+Initialize with your [Project API Key](https://taskbadger.net):
+
+```python
+import taskbadger
+
+taskbadger.init(token="YOUR_API_KEY")
+```
 
-- **Task States**: Track the status of tasks with various states such as `pending`, `in_progress`, `completed`, `error`, and more.
-- **Actions and Triggers**: Automate actions based on task events using flexible trigger definitions.
-- **Integrations**: Connect with various services like email, webhooks, and more to extend the functionality of Task Badger
-- **Monitoring and Alerts**: Stay informed with real-time monitoring and customizable alerts for task events.
+Create and track a task:
 
-## Getting Started
+```python
+from taskbadger import Task, StatusEnum
 
-To get started with Task Badger, check out the following sections:
+task = Task.create("my task")
+task.update(status=StatusEnum.PROCESSING, value=50)
+task.update(status=StatusEnum.SUCCESS, value=100)
+```
 
-- [Quick Start Guide](quick.md): Learn how to set up and start using Task Badger.
-- [Task States](data_model.md): Understand the different states a task can be in and how they are managed.
-- [Task Actions](data_model.md#task-actions): Discover how to configure actions and triggers to automate your workflows.
-- [API Reference](api.md): Explore the API documentation to integrate Task Badger with your applications.
-- [Python SDK](python.md): Get started with the Python SDK to interact with Task Badger programmatically.
+Or monitor Celery tasks automatically with the [Celery integration](python-celery.md):
 
-## Community and Support
+```python
+from taskbadger.systems import CelerySystemIntegration
+
+taskbadger.init(
+    token="YOUR_API_KEY",
+    systems=[CelerySystemIntegration()]
+)
+```
+
+Or track any shell command with the [CLI](cli.md):
+
+```bash
+taskbadger run "my task" -- ./script.sh
+```
+
+## Key Features
 
-Join our community to get help, share ideas, and stay updated with the latest news:
+- **Task tracking** — monitor status, progress, and metadata for any background job
+- **Celery integration** — automatic tracking of all Celery tasks with zero code changes
+- **Actions and triggers** — get notified via email, webhook, or other integrations on task events
+- **CLI** — monitor shell commands without writing code
 
-- [GitHub](https://github.com/Task Badger): Report issues, contribute to the project, and browse the source code.
-- [Twitter](https://twitter.com/@task_badger): Follow us for updates and announcements.
+## Learn More
 
-We hope you find Task Badger useful and look forward to your feedback!# Welcome to Task Badger Documentation
+- [Quick Start](quick.md) — full setup walkthrough
+- [Python SDK](python.md) — SDK reference
+- [CLI](cli.md) — command line usage
+- [Data Model](data_model.md) — task states, actions, and triggers
+- [API Endpoints](api.md) — REST API reference