docs: add comprehensive Polls feature documentation

docs/intro.md

@@ -50,7 +50,7 @@ Learn more about [how feeds work](key-features/feeds).
 Build your presence and connect with other developers through our vibrant community features:
 
 - **Create a profile**: Set up your [developer profile](your-profile/activity) to participate fully
-- **Engage with content**: [Upvote](key-features/upvotes), comment, and [bookmark](key-features/bookmarks) posts
+- **Engage with content**: [Upvote](key-features/upvotes), comment, [create polls](key-features/polls), and [bookmark](key-features/bookmarks) posts
 - **Join developer Squads**: Discover and join [Squads](squads/creating-your-squad) - specialized communities focused on specific technologies, topics, or interests
 - **Create your own Squad**: Start your own developer community around your expertise or interests
 - **Share your activity**: Generate and share your [DevCard](your-profile/devcard) to showcase your interests and reading habits
@@ -70,6 +70,7 @@ Make daily.dev work exactly how you want:
 
 - 🔍 **[Search](key-features/search)**: Find specific content across all sources
 - 💬 **[Discussions](key-features/discussions)**: Engage in meaningful conversations
+- 🗳️ **[Polls](key-features/polls)**: Gather community opinions with interactive voting
 - 👥 **[Squads](squads/creating-your-squad)**: Join or create developer communities around shared interests - the heart of daily.dev's community experience with specialized groups for technologies like React, AI, DevOps, and more
 - 📱 **[The Companion](key-features/the-companion)**: Quick access widget for seamless browsing
 

docs/key-features/bookmarks.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 6
 description: "Learn how to save, organize, and sync daily.dev bookmarks across devices and share them on GitHub for seamless access and integration."
 ---
 

docs/key-features/community-picks.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 9
+sidebar_position: 10
 description: "Learn about Community Picks on daily.dev and how content contribution has evolved with the new direct posting feature."
 ---
 

docs/key-features/discussions.md

@@ -11,6 +11,10 @@ Discussions are a valuable way to engage with the professional developer communi
 
 As a professional network for developers, we highly value the opportunity for our community members to participate in public discussions. Discussions allow you to share your thoughts, insights, and experiences related to a post or topic and contribute to the community's collective knowledge.
 
+:::tip Looking for lighter engagement?
+Check out [Polls](/docs/key-features/polls) - a quick way to gather community opinions and spark discussions with just one click!
+:::
+
 Participating in discussions can benefit you in several ways:
 1. Gain insights from others: Discussions provide an opportunity to learn from other experienced developers who have read the post. You can gain additional insights, perspectives, and tips to enhance your understanding of the topic.
 

docs/key-features/pause-new-tab.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 7
 description: "Learn how to use the Pause New Tab (Do Not Disturb) feature on daily.dev to minimize distractions and focus on your work."
 ---
 

docs/key-features/polls.md

@@ -0,0 +1,150 @@
+---
+sidebar_position: 5
+description: "Create and participate in polls on daily.dev to gather community opinions and engage with quick, interactive questions."
+---
+
+# Polls
+
+## What are polls?
+
+Polls are an interactive post type on daily.dev that allow users to create multiple-choice questions and gather community opinions with a single click. They provide a frictionless way to engage with the developer community and collect structured feedback on various topics.
+
+Each poll includes:
+- 2–4 answer options
+- One-click voting mechanism
+- Real-time results with vote counts and percentages
+- 7-day active voting period
+- Full integration with daily.dev's commenting, upvoting, and sharing features
+
+Polls bridge the gap between passive consumption and active participation, offering a middle ground for users who want to contribute meaningfully without writing lengthy comments.
+
+**[See a live poll in action →](https://app.daily.dev/posts/can-you-guess-which-feature-we-just-shipped--cpg33xsvg)**
+
+## Why use polls?
+
+Polls offer several benefits for community engagement:
+
+1. **Low-effort participation**: Vote with a single click without needing to write detailed responses
+2. **Instant gratification**: See immediate results and community sentiment
+3. **Structured feedback**: Generate clear, queryable data compared to freeform comments
+4. **Community insights**: Discover what the developer community thinks about specific topics
+5. **Discussion starters**: Use poll results as a foundation for deeper conversations
+
+## How to create a poll
+
+### Starting a new poll
+
+1. Click the "+" button or "Create Post" button in your feed
+2. Select "Create Poll" from the options
+3. Fill in the required information:
+   - **Question**: Write your poll question (be clear and specific)
+   - **Answer options**: Add 2–4 possible answers
+   - **Audience**: Choose to post to everyone or a specific Squad
+
+### Poll creation tips
+
+- **Keep questions clear**: Write concise, unambiguous questions
+- **Provide balanced options**: Ensure answer choices cover the likely range of opinions
+- **Use relevant tags**: Help users find polls related to their interests
+- **Consider your audience**: Tailor the question complexity to your intended audience
+
+## How to participate in polls
+
+### Voting in polls
+
+Polls appear directly in your feed with a distinct visual layout:
+
+1. **Identify poll posts**: Look for the "Poll" label in the top-left of the card
+2. **Read the question**: Review the poll question and available options
+3. **Cast your vote**: Click on your preferred answer option
+4. **View results**: After voting, see the percentage breakdown and vote counts for all options
+
+### Important voting details
+
+- **One vote per poll**: You can only vote once, and votes cannot be changed
+- **Anonymous voting**: Your individual vote choice is private
+- **Login required**: You must be logged in to vote
+- **Results visibility**: Vote counts and percentages are only visible after you vote
+
+## Poll lifecycle
+
+### Active polls (First 7 days)
+
+- Users can vote and see results immediately after voting
+- Comments, upvotes, bookmarks, and shares work normally
+- Poll creator and voters receive engagement notifications
+
+### Expired polls (After 7 days)
+
+- Voting is automatically disabled
+- Results remain permanently visible to all users
+- Commenting and other interactions continue to work
+- Final results notifications are sent to the creator and all voters
+
+## Engaging with poll results
+
+### Post-vote discussions
+
+After voting, consider engaging further:
+
+- **Comment on results**: Share why you voted a particular way
+- **Discuss surprising outcomes**: Engage when results don't match your expectations
+- **Ask follow-up questions**: Use poll results to spark deeper conversations
+- **Share insights**: Provide context or expertise related to the poll topic
+
+### Using poll data
+
+Poll results can inform:
+- **Technology decisions**: See what tools the community prefers
+- **Industry trends**: Understand emerging patterns in development
+- **Learning priorities**: Discover what skills other developers value
+- **Community sentiment**: Gauge opinions on controversial topics
+
+## Poll notifications
+
+You'll receive notifications for:
+
+### As a poll creator
+- When your poll receives votes
+- When someone comments on your poll
+- When your poll expires (final results summary)
+
+### As a poll participant
+- When a poll you voted in expires (final results)
+- When there's significant activity on polls you've engaged with
+
+## Content preferences
+
+Like other post types, you can customize your poll experience:
+
+1. Go to your **Content Preferences** settings
+2. Find the **Content Types** section
+3. Toggle polls on or off based on your preferences
+4. Adjust frequency settings if you want to see fewer or more polls
+
+## Best practices
+
+### For poll creators
+
+- **Ask relevant questions**: Focus on topics that interest the developer community
+- **Provide context**: Include background information when helpful
+- **Engage with voters**: Respond to comments and explain your reasoning
+- **Follow up**: Share insights or conclusions based on the results
+
+### For poll participants
+
+- **Vote thoughtfully**: Consider your answer carefully, as you can't change it
+- **Explain your choice**: Use comments to provide context for your vote
+- **Respect different opinions**: Remember that polls reveal diverse community perspectives
+- **Stay engaged**: Return to see final results and ongoing discussions
+
+## Moderation and quality
+
+Polls follow the same community guidelines as other posts:
+
+- Report inappropriate or spam polls using the report function
+- Polls are subject to the same content moderation policies
+- Community members can upvote high-quality polls and downvote poor ones
+- Rate limiting applies to poll creation just like regular posts
+
+Polls represent a new way to engage with the daily.dev community, offering structured interaction that complements existing discussion formats while providing valuable insights into developer opinions and trends.

docs/key-features/the-companion.md

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 9
 description: "Learn about the daily.dev Companion Widget, its features, activation process, and how it enhances user engagement directly on post pages."
 ---
 

docs/squads/creating-your-squad.md

@@ -23,7 +23,7 @@ Squads offer several interactive features to create an engaging experience:
 
 ✨ **Invite Members**: Bring in developers to discuss, share resources, and collaborate.
 
-✨ **Post & Share Content**: Depending on settings, posting can be open to everyone or restricted to moderators. Enjoy full Markdown compatibility for rich discussions.
+✨ **Post & Share Content**: Depending on settings, posting can be open to everyone or restricted to moderators. Share articles, create [polls](/docs/key-features/polls) to gather squad opinions, and enjoy full Markdown compatibility for rich discussions.
 
 ✨ **Moderation Tools**: As an admin, you have tools to manage posts, comments, and member interactions. 
 

src/components/homepage/homeNavBoxes.js

@@ -40,6 +40,7 @@
       { url: 'docs/key-features/feeds', text: 'Feeds' },
       { url: 'docs/key-features/upvotes', text: 'Upvotes & Downvotes' },
       { url: 'docs/key-features/discussions', text: 'Discussions' },
+      { url: 'docs/key-features/polls', text: 'Polls' },
       { url: 'docs/key-features/bookmarks', text: 'Bookmarks' },
       { url: 'docs/key-features/search', text: 'Search' },
       { url: 'docs/key-features/pause-new-tab', text: 'Pause New Tab (DND)' },
@@ -157,7 +158,7 @@
   },
 ];
 
 function FeatureItem({ url, text }) {
   return (
     <li>
       <Link className={styles.listContainerLink} to={url}>
@@ -167,7 +168,7 @@
   );
 }
 
 function Feature({ title, icon, items }) {
   const altTexts = {
     'Getting Started': 'Navigate to getting started guides and tutorials',
     'Setting up your feed': 'Customize and configure your content feed',