DOCS: create README with beginner guide

Added detailed setup instructions and project overview.

Author: ErkanSoftwareDeveloper

README.md

@@ -1,2 +1,161 @@
 # discord-meme-bot
 A Discord meme bot for servers that are too lazy to post memes every week.
+No server. No hosting. Fully automated.
+
+---
+
+## What is this?
+
+This project automatically sends memes to a Discord channel using a secure webhook system.
+
+Once set up, it runs completely in the background via GitHub Actions.
+
+---
+
+## Quick Start (3 Steps)
+
+### 1. Clone the repository
+
+git clone https://github.com/ErkanSoftwareDeveloper/discord-meme-bot.git  
+cd discord-meme-bot
+
+---
+
+### 2. Install dependencies
+
+pip install -r requirements.txt
+
+---
+
+### 3. Add Discord webhook (IMPORTANT)
+
+You will NOT put the webhook in the code.
+
+Instead, you will add it to GitHub Secrets.
+
+---
+
+## Create Discord Webhook
+
+In Discord:
+
+1. Open your server
+2. Go to the channel where memes should be posted
+3. Click "Edit Channel"
+4. Go to "Integrations"
+5. Open "Webhooks"
+6. Click "New Webhook"
+7. Copy the Webhook URL
+
+Keep this URL private. Treat it like a password.
+
+---
+
+## GitHub Secrets Setup
+
+Go to your repository:
+
+Settings → Secrets and variables → Actions → New repository secret
+
+Add:
+
+Name:
+DISCORD_WEBHOOK_URL
+
+Value:
+Your Discord webhook URL
+
+IMPORTANT:
+- Do NOT put this in code
+- Do NOT commit `.env`
+- Only use GitHub Secrets
+
+---
+
+## How it runs
+
+- GitHub Actions runs the bot automatically
+- Python script executes
+- Meme is sent to Discord
+- Process finishes
+
+You can also run it manually from the GitHub Actions tab.
+
+---
+
+## GitHub Actions
+
+The bot runs on schedule using GitHub Actions.
+
+You can:
+- Run it daily or weekly
+- Trigger it manually
+- Let it run automatically in the cloud
+
+No hosting required.
+
+---
+
+## Project Structure
+
+discord-meme-bot/
+├── main.py
+├── requirements.txt
+├── .github/workflows/
+└── README.md
+
+---
+
+## Security Rules (IMPORTANT)
+
+- Webhook URL = password
+- Never share it
+- Never commit `.env`
+- If leaked, delete webhook and create a new one
+- Always use GitHub Secrets
+
+---
+
+## Common mistakes
+
+If something doesn’t work, check:
+
+- Secret name is exactly: DISCORD_WEBHOOK_URL
+- Workflow file exists in `.github/workflows/`
+- Dependencies installed
+- Webhook URL is valid
+- You did NOT hardcode secrets anywhere
+
+---
+
+## Why GitHub Actions?
+
+- No server needed
+- Free automation
+- Reliable scheduling
+- Works 24/7 in the cloud
+
+---
+
+## Summary
+
+To set up:
+
+1. Clone repo
+2. Install dependencies
+3. Add webhook to GitHub Secrets
+4. Run Actions
+
+Done. It works automatically.
+
+---
+
+## Screenshot
+
+<img width="663" height="349" alt="screenshot_discord" src="https://github.com/user-attachments/assets/f2cd1755-1bd7-4098-933a-3a0c1b040cfd" />
+
+---
+
+## License
+
+MIT License