refactor: reorganize logger and formatter documentation structure

docs/docs/api/base/swarmauri_base/agents/AgentBase.md

@@ -3,3 +3,4 @@
 ::: swarmauri_base.agents.AgentBase.AgentBase
     options.extra:
       show_inheritance: true
+

docs/docs/api/base/swarmauri_base/logger_formatters/FormatterBase.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_base.logger_formatters.FormatterBase.FormatterBase`
+
+::: swarmauri_base.logger_formatters.FormatterBase.FormatterBase
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/base/swarmauri_base/logger_handlers/HandlerBase.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_base.logger_handlers.HandlerBase.HandlerBase`
+
+::: swarmauri_base.logger_handlers.HandlerBase.HandlerBase
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/base/swarmauri_base/loggers/LoggerBase.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_base.loggers.LoggerBase.LoggerBase`
+
+::: swarmauri_base.loggers.LoggerBase.LoggerBase
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/core/swarmauri_core/logger_formatters/IFormatter.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_core.logger_formatters.IFormatter.IFormatter`
+
+::: swarmauri_core.logger_formatters.IFormatter.IFormatter
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/core/swarmauri_core/logger_handlers/IHandler.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_core.logger_handlers.IHandler.IHandler`
+
+::: swarmauri_core.logger_handlers.IHandler.IHandler
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/core/swarmauri_core/loggers/ILogger.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_core.loggers.ILogger.ILogger`
+
+::: swarmauri_core.loggers.ILogger.ILogger
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/core/swarmauri_core/tool_llms/IToolPredict.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_core.tool_llms.IToolPredict.IToolPredict`
+
+::: swarmauri_core.tool_llms.IToolPredict.IToolPredict
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/standard/swarmauri_standard/loggers/Logger.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_standard.loggers.Logger.Logger`
+
+::: swarmauri_standard.loggers.Logger.Logger
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/standard/swarmauri_standard/tool_llms/DeepInfraToolModel.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_standard.tool_llms.DeepInfraToolModel.DeepInfraToolModel`
+
+::: swarmauri_standard.tool_llms.DeepInfraToolModel.DeepInfraToolModel
+    options.extra:
+      show_inheritance: true
+

docs/docs/api/standard/swarmauri_standard/tool_llms/ToolLLM.md

@@ -0,0 +1,6 @@
+# Class `swarmauri_standard.tool_llms.ToolLLM.ToolLLM`
+
+::: swarmauri_standard.tool_llms.ToolLLM.ToolLLM
+    options.extra:
+      show_inheritance: true
+

docs/docs/guide/faq.md

@@ -17,11 +17,10 @@ pip install swarmauri
 ```
 
 !!! info "Installation Options"
-    For specific versions or development builds:
-    ```bash
-    # Install specific version
-    pip install swarmauri==1.2.3
-
+For specific versions or development builds:
+```bash # Install specific version
+pip install swarmauri==1.2.3
+
     # Install from GitHub (latest development version)
     pip install git+https://github.com/swarmauri/swarmauri-sdk.git
     ```
@@ -49,11 +48,7 @@ If you encounter `ModuleNotFoundError`:
 pip list | grep swarmauri
 ```
 
-!!! warning "Common Import Error Causes"
-    - Package not installed correctly
-    - Virtual environment not activated
-    - Package installed in a different Python environment
-    - Package name misspelled in the import statement
+!!! warning "Common Import Error Causes" - Package not installed correctly - Virtual environment not activated - Package installed in a different Python environment - Package name misspelled in the import statement
 
 ### Version Conflicts
 
@@ -69,12 +64,12 @@ pip install swarmauri
 ```
 
 !!! tip "Dependency Isolation"
-    Consider using tools like Poetry or pipenv for better dependency management. These tools create lockfiles that ensure consistent environments across different machines.
-    
+Consider using tools like Poetry or pipenv for better dependency management. These tools create lockfiles that ensure consistent environments across different machines.
+
     ```bash
     # Using Poetry
     poetry add swarmauri
-    
+
     # Using pipenv
     pipenv install swarmauri
     ```
@@ -94,8 +89,8 @@ sudo apt install build-essential  # For Ubuntu/Debian
 ```
 
 ??? danger "Installation Troubleshooting"
-    If you encounter persistent installation issues:
-    
+If you encounter persistent installation issues:
+
     1. Make sure your pip is up to date: `pip install --upgrade pip`
     2. Check if you have sufficient privileges (try using `sudo` on Linux/Mac or run as administrator on Windows)
     3. If you're behind a corporate firewall, you may need to configure pip to use an HTTPS proxy
@@ -140,13 +135,13 @@ print(response)
 ```
 
 !!! info "Available Tools"
-    Swarmauri SDK offers a variety of built-in tools including:
+Swarmauri SDK offers a variety of built-in tools including:
 
     - `CalculatorTool`: For mathematical operations
     - `RequestsTool`: For HTTP requests
     - `CodeExtractorTool`: For code extraction
     - `CodeInterpreterTool`: For python code execution
-    
+
     You can also create custom tools by extending the `ToolBase` class.
 
 ### How do I create an AI assistant?
@@ -174,6 +169,7 @@ print(response)
 response = agent.exec("Can you explain it in simpler terms?")
 print(response)
 ```
+
 ### How do I handle large datasets?
 
 - **Chunking**: Break down large datasets into smaller chunks for processing.
@@ -232,3 +228,6 @@ If you need further assistance:
 1. Check our API Documentation
 2. Visit our [GitHub Issues](https://github.com/swarmauri/swarmauri-sdk/issues)
 3. Join our [Discord Community](https://discord.gg/swarmauri)
+
+!!! info "Community Support"
+    Our community is active and ready to help with any questions you might have. Don't hesitate to reach out if you're facing challenges with Swarmauri SDK.

docs/docs/guide/index.md

@@ -9,7 +9,7 @@ Welcome to Swarmauri guides! This section contains practical tutorials and how-t
 
 - **[Installation Guide](installation.md)** - Step-by-step instructions for setting up Swarmauri SDK
 - **[Usage Guide](usage.md)** - Learn how to use core Swarmauri features
-- **[Courses](course/1.md)** - Structured learning paths for different skill levels
+- **[Courses](courses.md)** - Structured learning paths for different skill levels
 - **[FAQ](faq.md)** - Answers to frequently asked questions
 
 ## Learning Paths
@@ -21,15 +21,15 @@ Choose the path that fits your needs:
 
 ### 1. Beginners
 
-Start with the **[Installation Guide](installation.md)** followed by the **[Entry Course](course/1.md)**. This path introduces core concepts without assuming prior AI development experience.
+Start with the **[Installation Guide](installation.md)** followed by the **[Entry Course](courses.md)**. This path introduces core concepts without assuming prior AI development experience.
 
 ### 2. AI/ML Practitioners
 
-Begin with **[Installation Guide](installation.md)** and jump straight to the **[Generative AI Course](course/2.md)**. This path focuses on using Swarmauri with existing AI/ML knowledge.
+Begin with **[Installation Guide](installation.md)** and jump straight to the **[Generative AI Course](courses.md)**. This path focuses on using Swarmauri with existing AI/ML knowledge.
 
 ### 3. Tool Developers
 
-After installation, explore the **[Tool Development Course](course/3.md)**. This path is ideal if you want to extend Swarmauri with custom components.
+After installation, explore the **[Tool Development Course](courses.md)**. This path is ideal if you want to extend Swarmauri with custom components.
 
 !!! warning "Prerequisites"
     The Tool Development path assumes familiarity with Python development practices, including package management, testing, and object-oriented programming concepts.
@@ -52,7 +52,7 @@ If this is your first time using Swarmauri, we recommend:
 
 1. Install the SDK using the [Installation Guide](installation.md)
 2. Follow the basic examples in the [Usage Guide](usage.md)
-3. Explore more advanced concepts in our [Courses](course/1.md)
+3. Explore more advanced concepts in our [Courses](courses.md)
 
 !!! note "Community Support"
     Need help? Visit our [community resources](../home/help.md) or check the [FAQ](faq.md). Our active community is ready to assist with any questions you might have.

docs/docs/home/installation.md

@@ -132,19 +132,19 @@ print(swarmauri.__version__)
 
 After installation:
 
-1. Check out our [Quickstart Guide](../guide/quickstart.md)
-2. Review [API Documentation](../api/index.md)
-3. Try our [Examples](../examples/index.md)
-4. Join our [Community](../community/index.md)
+1. Check out our [Quickstart Guide](../guide/usage.md)
+2. Review [API Documentation](../api/concepts.md)
+3. Try our [Courses](../guide/courses.md)
+4. Join our [Community](https://discord.gg/swarmauri)
 
 !!! tip "Getting Started"
-    The [Quickstart Guide](../guide/quickstart.md) is the best place to begin your journey with Swarmauri SDK.
+    The [Quickstart Guide](../guide/usage.md) is the best place to begin your journey with Swarmauri SDK.
 
 ## Getting Help
 
 If you run into issues:
 
-1. Check our [FAQ](../faq.md)
+1. Check our [FAQ](../guide/faq.md)
 2. Visit our [GitHub Issues](https://github.com/swarmauri/swarmauri-sdk/issues)
 3. Join our [Discord Community](https://discord.gg/swarmauri)
 

docs/docs/home/why_use_swarmauri.md

@@ -74,8 +74,8 @@ Build AI agents that can use tools to accomplish tasks:
 - **Jupyter notebook tools** for data science workflows
 - **Custom tools** that you can easily build and integrate
 
-!!! tip "Custom Tools"
-Creating your own tools is straightforward with Swarmauri. Extend the `ToolBase` class, register it with `@ComponentBase.register_type`, and implement the `__call__` method. See the [Custom Components](../guide/usage.md#creating-custom-components) section for examples.
+???+ tip "Custom Tools"
+    Creating your own tools is straightforward with Swarmauri. Extend the `ToolBase` class, register it with `@ComponentBase.register_type`, and implement the `__call__` method. See the [Custom Components](../guide/usage.md#creating-custom-components) section for examples.
 
 ### Data Processing
 
@@ -357,8 +357,8 @@ Discover how easy it is to build with Swarmauri:
 
 - [Installation Guide](installation.md) - Get set up with Swarmauri SDK
 - [Quick Start Tutorial](../guide/usage.md) - Build your first AI application
-- [Examples Gallery](../examples/index.md) - Explore example projects
-- [API Reference](../api/index.md) - Dive into detailed documentation
+- [ Courses ](../guide/courses.md) - Explore our Courses
+- [API Reference](../api/concepts.md) - Dive into detailed documentation
 
 Or jump right in with a simple example:
 

docs/docs/index.md

@@ -288,11 +288,11 @@ Need help? Have a feature suggestion? Join the Swarmauri community:
 
 Here are some recommended next steps to continue your journey with Swarmauri SDK:
 
-1. **Explore the Tutorials**: Check out our [step-by-step tutorials](../tutorials/index.md)
-2. **Read the API Documentation**: Dive into our [detailed API reference](../api/index.md)
+1. **Explore the Courses**: Check out our [step-by-step courses](./guide/courses.md)
+2. **Read the API Documentation**: Dive into our [detailed API reference](./api/concepts.md)
 3. **Join the Community**: Connect with other developers in our [Discord server](https://discord.gg/swarmauri)
 4. **Contribute**: Learn how to [contribute to the project](./home/contribute.md)
-5. **Stay Updated**: Follow our [blog](../blog/index.md) for the latest updates
+5. **Stay Updated**: Follow our [blog](./blog/index.md) for the latest updates
 
 ---