docs: configuration

Author: evolvewithevan

docs/src/getting-started/configuration.md

@@ -1,51 +1,39 @@
 # Configuration
 
-Learn how to configure GitCord to suit your needs.
+Set up GitCord for your needs.
 
 ## Environment Variables
 
-GitCord uses environment variables for configuration. Create a `.env` file in the project root:
+Create a `.env` file in the project root:
 
 ```env
 # Required: Your Discord bot token
 DISCORD_TOKEN=your_bot_token_here
 
-# Optional: Logging level (DEBUG, INFO, WARNING, ERROR)
-LOG_LEVEL=INFO
-
-# Optional: Bot prefix for legacy commands (default: !)
-COMMAND_PREFIX=!
-
-# Optional: Database URL for persistent storage
-DATABASE_URL=sqlite:///gitcord.db
+# Optional: Bot prefix for commands (default: !)
+PREFIX=!
 ```
 
-## Bot Configuration
+## Bot Permissions
 
-### Permissions
-
-Ensure your bot has these permissions:
+Your bot needs these permissions:
 
 - **Manage Channels**: Create, edit, and delete channels
-- **Manage Roles**: Set up channel permissions
 - **Send Messages**: Send responses to commands
 - **Embed Links**: Send rich embeds
 - **Use Slash Commands**: Register and use slash commands
-- **Attach Files**: Upload template files
 
-### Intents
+## Discord Intents
 
-The bot requires these Discord intents:
+The bot needs these Discord intents:
 
 - **Guilds**: Access server information
 - **Guild Messages**: Read and send messages
 - **Message Content**: Read message content for prefix commands
 
-## Template Configuration
-
-### YAML Structure
+## YAML Templates
 
-Templates use YAML format with this structure:
+Templates use YAML format:
 
 ```yaml
 # Single channel
@@ -59,119 +47,47 @@ nsfw: Optional boolean for NSFW channels
 name: category-name
 type: category
 channels:
-  - name: channel-1
-    type: text
-    topic: Channel description
-  - name: channel-2
-    type: voice
-    topic: Voice channel description
-```
-
-### Template Locations
-
-Templates can be stored in:
-
-1. **Built-in templates**: `gitcord-template/` directory
-2. **Custom templates**: Upload via Discord commands
-3. **Local files**: Reference local YAML files
-
-## Logging Configuration
-
-Configure logging in your environment:
-
-```env
-# Log level options
-LOG_LEVEL=DEBUG    # Most verbose
-LOG_LEVEL=INFO     # Standard information
-LOG_LEVEL=WARNING  # Warnings and errors only
-LOG_LEVEL=ERROR    # Errors only
+  - channel-1
+  - channel-2
 ```
 
-## Database Configuration
+## Template Locations
 
-For persistent storage, configure a database:
+Templates are available exclusively at:
 
-```env
-# SQLite (default)
-DATABASE_URL=sqlite:///gitcord.db
+- [gitcord-template GitHub Repository](https://github.com/evolvewithevan/gitcord-template)
 
-# PostgreSQL
-DATABASE_URL=postgresql://user:password@localhost/gitcord
+## Logging
 
-# MySQL
-DATABASE_URL=mysql://user:password@localhost/gitcord
-```
+GitCord uses Python's built-in logging. Logs go to the console by default.
 
-## Custom CSS and JavaScript
+**Note:** Database configuration and advanced options are not currently available.
 
-Add custom styling to the documentation:
+## Security
 
-1. Create `docs/src/custom.css`:
-   ```css
-   /* Custom styles */
-   .book-summary {
-       background-color: #f5f5f5;
-   }
-   ```
-
-2. Create `docs/src/custom.js`:
-   ```javascript
-   // Custom JavaScript
-   console.log('GitCord documentation loaded');
-   ```
-
-## Advanced Configuration
-
-### Command Cooldowns
-
-Configure command cooldowns in the bot code:
-
-```python
-# In cog files
-@commands.cooldown(1, 30, commands.BucketType.guild)
-async def create_channel(self, ctx):
-    # Command implementation
-```
-
-### Error Handling
-
-Customize error handling:
-
-```python
-# Global error handler
-@bot.event
-async def on_command_error(ctx, error):
-    if isinstance(error, commands.MissingPermissions):
-        await ctx.send("You don't have permission to use this command.")
-```
-
-## Security Considerations
-
-- Keep your bot token secure and never commit it to version control
-- Use environment variables for sensitive configuration
+- Keep your bot token secure
+- Never commit tokens to version control
+- Use environment variables for sensitive data
 - Regularly rotate your bot token
-- Limit bot permissions to only what's necessary
-- Monitor bot activity and logs
+- Give bot only necessary permissions
 
-## Troubleshooting Configuration
+## Problems?
 
 ### Common Issues
 
 1. **Bot not responding**: Check token and permissions
 2. **Commands not working**: Verify slash commands are registered
-3. **Template errors**: Validate YAML syntax
+3. **Template errors**: Check YAML syntax
 4. **Permission errors**: Ensure bot has required permissions
 
 ### Debug Mode
 
 Enable debug mode for detailed logging:
 
 ```env
-LOG_LEVEL=DEBUG
+DEBUG=true
 ```
 
-This provides verbose output for troubleshooting configuration issues.
-
 ## Next Steps
 
 - Learn about [Available Commands](../user-guide/commands.md)