From f9ee0ca96b24da39e2318cbcfcce629b87ee338f Mon Sep 17 00:00:00 2001
From: Larry Sinclair <larry.sinclair.01.crypto@gmail.com>
Date: Sun, 28 Sep 2025 10:24:44 -0600
Subject: [PATCH] feat: add documentation for polls feature including API
 endpoints and usage

---
 docs/polls.md | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 docs/polls.md

diff --git a/docs/polls.md b/docs/polls.md
new file mode 100644
index 0000000..701db80
--- /dev/null
+++ b/docs/polls.md
@@ -0,0 +1,41 @@
+# Polls Feature
+
+This document describes the polls feature in the Devoter API.
+
+## Overview
+
+The polls feature allows users to create, manage, and participate in polls.
+
+## API Endpoints
+
+- `GET /polls` - Retrieve a list of polls
+- `POST /polls` - Create a new poll
+- `GET /polls/:id` - Retrieve a specific poll
+- `PUT /polls/:id` - Update a poll
+- `DELETE /polls/:id` - Delete a poll
+
+## Usage
+
+### Creating a Poll
+
+To create a poll, send a POST request to `/polls` with the following JSON payload:
+
+```json
+{
+  "title": "Sample Poll",
+  "options": ["Option 1", "Option 2", "Option 3"],
+  "expiresAt": "2023-12-31T23:59:59Z"
+}
+```
+
+### Voting on a Poll
+
+To vote on a poll, send a POST request to `/polls/:id/vote` with the selected option.
+
+## Error Handling
+
+Refer to the [Error Handling](error-handling.md) documentation for common error responses.
+
+## Rate Limiting
+
+This feature is subject to rate limiting as described in the [Rate Limiting](rate-limiting.md) documentation.