# User Guides

Practical guides for common tasks and workflows with bfabricPy.

```{toctree}
:maxdepth: 2
creating_a_client/index
reading_data/index
writing_data/index
working_with_entities/index
bfabric-cli/index
error_handling
```

## Guides Overview

| Guide | Description | Skill Level |
| ------------------------------------------------------- | ---------------------------------------------- | ------------ |
| [Creating a Client](creating_a_client/index.md) | Set up authentication for scripts and web apps | Beginner |
| [Reading Data](reading_data/index.md) | Query B-Fabric and retrieve data | Beginner |
| [Writing Data](writing_data/index.md) | Create, update, and delete entities | Intermediate |
| [Working with Entities](working_with_entities/index.md) | Use typed entities and relationships | Intermediate |
| [bfabric-cli](bfabric-cli/index.md) | Command-line interface for bfabric-cli | All Levels |
| [Error Handling](error_handling.md) | Error types, patterns, and handling strategies | All Levels |

## Common Workflows

- **[Dataset Features](working_with_entities/index#datasets)** - Dataset exports and data access
- **[Performance Optimization](reading_data/caching_for_performance)** - Cache entities for speed
- **[CLI Quick Operations](bfabric-cli/index)** - Quick one-off tasks with bfabric-cli

## Quick Links

- [Quick Start](../getting_started/quick_start) - 5-minute tutorial
- [API Reference](../api_reference/index) - Complete API documentation
- [Error Handling](error_handling.md) - Error patterns and solutions

## Need Help?

- Check [Good to Know](../../resources/good_to_know) for useful tips
- Review [API Reference](../api_reference/index) for method details
