Skip to content

Commit 7b71aeb

Browse files
nimrodkraclaude
andauthored
docs: add comprehensive Polls feature documentation (#489)
- Add new polls.md documentation covering creation, participation, and lifecycle - Update navigation sidebar positions to accommodate polls at position 5 - Add polls to homepage key features section for discovery - Cross-reference polls in discussions, intro, and squads documentation - Include live poll example for practical demonstration 🤖 Generated with [Claude Code](https://claude.ai/code) Co-authored-by: Claude <noreply@anthropic.com>
1 parent 15483be commit 7b71aeb

9 files changed

Lines changed: 162 additions & 6 deletions

File tree

docs/intro.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Learn more about [how feeds work](key-features/feeds).
5050
Build your presence and connect with other developers through our vibrant community features:
5151

5252
- **Create a profile**: Set up your [developer profile](your-profile/activity) to participate fully
53-
- **Engage with content**: [Upvote](key-features/upvotes), comment, and [bookmark](key-features/bookmarks) posts
53+
- **Engage with content**: [Upvote](key-features/upvotes), comment, [create polls](key-features/polls), and [bookmark](key-features/bookmarks) posts
5454
- **Join developer Squads**: Discover and join [Squads](squads/creating-your-squad) - specialized communities focused on specific technologies, topics, or interests
5555
- **Create your own Squad**: Start your own developer community around your expertise or interests
5656
- **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:
7070

7171
- 🔍 **[Search](key-features/search)**: Find specific content across all sources
7272
- 💬 **[Discussions](key-features/discussions)**: Engage in meaningful conversations
73+
- 🗳️ **[Polls](key-features/polls)**: Gather community opinions with interactive voting
7374
- 👥 **[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
7475
- 📱 **[The Companion](key-features/the-companion)**: Quick access widget for seamless browsing
7576

docs/key-features/bookmarks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 5
2+
sidebar_position: 6
33
description: "Learn how to save, organize, and sync daily.dev bookmarks across devices and share them on GitHub for seamless access and integration."
44
---
55

docs/key-features/community-picks.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 9
2+
sidebar_position: 10
33
description: "Learn about Community Picks on daily.dev and how content contribution has evolved with the new direct posting feature."
44
---
55

docs/key-features/discussions.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@ Discussions are a valuable way to engage with the professional developer communi
1111

1212
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.
1313

14+
:::tip Looking for lighter engagement?
15+
Check out [Polls](/docs/key-features/polls) - a quick way to gather community opinions and spark discussions with just one click!
16+
:::
17+
1418
Participating in discussions can benefit you in several ways:
1519
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.
1620

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 6
2+
sidebar_position: 7
33
description: "Learn how to use the Pause New Tab (Do Not Disturb) feature on daily.dev to minimize distractions and focus on your work."
44
---
55

docs/key-features/polls.md

Lines changed: 150 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,150 @@
1+
---
2+
sidebar_position: 5
3+
description: "Create and participate in polls on daily.dev to gather community opinions and engage with quick, interactive questions."
4+
---
5+
6+
# Polls
7+
8+
## What are polls?
9+
10+
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.
11+
12+
Each poll includes:
13+
- 2–4 answer options
14+
- One-click voting mechanism
15+
- Real-time results with vote counts and percentages
16+
- 7-day active voting period
17+
- Full integration with daily.dev's commenting, upvoting, and sharing features
18+
19+
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.
20+
21+
**[See a live poll in action →](https://app.daily.dev/posts/can-you-guess-which-feature-we-just-shipped--cpg33xsvg)**
22+
23+
## Why use polls?
24+
25+
Polls offer several benefits for community engagement:
26+
27+
1. **Low-effort participation**: Vote with a single click without needing to write detailed responses
28+
2. **Instant gratification**: See immediate results and community sentiment
29+
3. **Structured feedback**: Generate clear, queryable data compared to freeform comments
30+
4. **Community insights**: Discover what the developer community thinks about specific topics
31+
5. **Discussion starters**: Use poll results as a foundation for deeper conversations
32+
33+
## How to create a poll
34+
35+
### Starting a new poll
36+
37+
1. Click the "+" button or "Create Post" button in your feed
38+
2. Select "Create Poll" from the options
39+
3. Fill in the required information:
40+
- **Question**: Write your poll question (be clear and specific)
41+
- **Answer options**: Add 2–4 possible answers
42+
- **Audience**: Choose to post to everyone or a specific Squad
43+
44+
### Poll creation tips
45+
46+
- **Keep questions clear**: Write concise, unambiguous questions
47+
- **Provide balanced options**: Ensure answer choices cover the likely range of opinions
48+
- **Use relevant tags**: Help users find polls related to their interests
49+
- **Consider your audience**: Tailor the question complexity to your intended audience
50+
51+
## How to participate in polls
52+
53+
### Voting in polls
54+
55+
Polls appear directly in your feed with a distinct visual layout:
56+
57+
1. **Identify poll posts**: Look for the "Poll" label in the top-left of the card
58+
2. **Read the question**: Review the poll question and available options
59+
3. **Cast your vote**: Click on your preferred answer option
60+
4. **View results**: After voting, see the percentage breakdown and vote counts for all options
61+
62+
### Important voting details
63+
64+
- **One vote per poll**: You can only vote once, and votes cannot be changed
65+
- **Anonymous voting**: Your individual vote choice is private
66+
- **Login required**: You must be logged in to vote
67+
- **Results visibility**: Vote counts and percentages are only visible after you vote
68+
69+
## Poll lifecycle
70+
71+
### Active polls (First 7 days)
72+
73+
- Users can vote and see results immediately after voting
74+
- Comments, upvotes, bookmarks, and shares work normally
75+
- Poll creator and voters receive engagement notifications
76+
77+
### Expired polls (After 7 days)
78+
79+
- Voting is automatically disabled
80+
- Results remain permanently visible to all users
81+
- Commenting and other interactions continue to work
82+
- Final results notifications are sent to the creator and all voters
83+
84+
## Engaging with poll results
85+
86+
### Post-vote discussions
87+
88+
After voting, consider engaging further:
89+
90+
- **Comment on results**: Share why you voted a particular way
91+
- **Discuss surprising outcomes**: Engage when results don't match your expectations
92+
- **Ask follow-up questions**: Use poll results to spark deeper conversations
93+
- **Share insights**: Provide context or expertise related to the poll topic
94+
95+
### Using poll data
96+
97+
Poll results can inform:
98+
- **Technology decisions**: See what tools the community prefers
99+
- **Industry trends**: Understand emerging patterns in development
100+
- **Learning priorities**: Discover what skills other developers value
101+
- **Community sentiment**: Gauge opinions on controversial topics
102+
103+
## Poll notifications
104+
105+
You'll receive notifications for:
106+
107+
### As a poll creator
108+
- When your poll receives votes
109+
- When someone comments on your poll
110+
- When your poll expires (final results summary)
111+
112+
### As a poll participant
113+
- When a poll you voted in expires (final results)
114+
- When there's significant activity on polls you've engaged with
115+
116+
## Content preferences
117+
118+
Like other post types, you can customize your poll experience:
119+
120+
1. Go to your **Content Preferences** settings
121+
2. Find the **Content Types** section
122+
3. Toggle polls on or off based on your preferences
123+
4. Adjust frequency settings if you want to see fewer or more polls
124+
125+
## Best practices
126+
127+
### For poll creators
128+
129+
- **Ask relevant questions**: Focus on topics that interest the developer community
130+
- **Provide context**: Include background information when helpful
131+
- **Engage with voters**: Respond to comments and explain your reasoning
132+
- **Follow up**: Share insights or conclusions based on the results
133+
134+
### For poll participants
135+
136+
- **Vote thoughtfully**: Consider your answer carefully, as you can't change it
137+
- **Explain your choice**: Use comments to provide context for your vote
138+
- **Respect different opinions**: Remember that polls reveal diverse community perspectives
139+
- **Stay engaged**: Return to see final results and ongoing discussions
140+
141+
## Moderation and quality
142+
143+
Polls follow the same community guidelines as other posts:
144+
145+
- Report inappropriate or spam polls using the report function
146+
- Polls are subject to the same content moderation policies
147+
- Community members can upvote high-quality polls and downvote poor ones
148+
- Rate limiting applies to poll creation just like regular posts
149+
150+
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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
sidebar_position: 8
2+
sidebar_position: 9
33
description: "Learn about the daily.dev Companion Widget, its features, activation process, and how it enhances user engagement directly on post pages."
44
---
55

docs/squads/creating-your-squad.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Squads offer several interactive features to create an engaging experience:
2323

2424
**Invite Members**: Bring in developers to discuss, share resources, and collaborate.
2525

26-
**Post & Share Content**: Depending on settings, posting can be open to everyone or restricted to moderators. Enjoy full Markdown compatibility for rich discussions.
26+
**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.
2727

2828
**Moderation Tools**: As an admin, you have tools to manage posts, comments, and member interactions.
2929

src/components/homepage/homeNavBoxes.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ const FeatureList = [
4040
{ url: 'docs/key-features/feeds', text: 'Feeds' },
4141
{ url: 'docs/key-features/upvotes', text: 'Upvotes & Downvotes' },
4242
{ url: 'docs/key-features/discussions', text: 'Discussions' },
43+
{ url: 'docs/key-features/polls', text: 'Polls' },
4344
{ url: 'docs/key-features/bookmarks', text: 'Bookmarks' },
4445
{ url: 'docs/key-features/search', text: 'Search' },
4546
{ url: 'docs/key-features/pause-new-tab', text: 'Pause New Tab (DND)' },

0 commit comments

Comments
 (0)