📝docs: sync with examples files, small updates

[TincoNomad]

Add some prints on example files with key information about possible error and a description in some examples about a correct way to have en environment variables for the correct use of the example

Also update the example docs and improve docs navigation.

[TincoNomad]

Tutorial and Examples Review Completion

Overview

Completed comprehensive review and validation of all tutorial sections and example code. All components have been tested and verified for functionality.

Completed Tasks

Tutorial Sections

• ✓ Project Setup and Installation
• ✓ Core Functionality Implementation
• ✓ Error Handling and Data Persistence
• ✓ Advanced Features and Visualization

Example Code Verification

• ✓ Basic Usage Examples
• ✓ Async Operations
• ✓ File Operations
• ✓ Docker Integration
• ✓ Error Handling Patterns

Key Improvements

Documentation Structure

• Organized tutorial sections with clear progression
• Added cross-references between related concepts
• Improved code comments and explanations

Code Quality

• Verified all code snippets execute successfully
• Added error handling for edge cases
• Improved type hints and documentation

Example Coverage

• Added missing examples for key features
• Updated outdated code patterns
• Expanded Docker usage examples

Testing Results

Core Tutorial Code

Successfully tested main components:

markdown:(docs/tutorial/core_functionality.md)

• startLine: 70
• endLine: 114

References

• Quick Start Guide
• API Reference
• Implementation Guide

All tutorial sections and examples are now ready for production use. Documentation provides a clear path from basic to advanced usage.