|
| 1 | +# Ready-to-Use Slack Messages for User Role Research |
| 2 | + |
| 3 | +## Week 1: Introduction and First Poll |
| 4 | + |
| 5 | +### Day 1: Introduction Message |
| 6 | +**Channel**: #general |
| 7 | +**Copy and paste this message**: |
| 8 | + |
| 9 | +``` |
| 10 | +👋 Hey AboutCode community! |
| 11 | +
|
| 12 | +We're working to better understand our diverse user base so we can improve our documentation, tools, and resources to serve everyone more effectively. |
| 13 | +
|
| 14 | +We'd love to learn more about who you are and what brings you to AboutCode. Over the next few weeks, we'll be sharing some quick polls to gather this info. |
| 15 | +
|
| 16 | +Your participation will help us: |
| 17 | +• Create better documentation for your specific needs |
| 18 | +• Prioritize features that matter most to your use case |
| 19 | +• Build resources that address your real-world challenges |
| 20 | +
|
| 21 | +First poll coming up tomorrow! 🧵 |
| 22 | +
|
| 23 | +Thanks in advance for helping us serve the community better! 🙏 |
| 24 | +``` |
| 25 | + |
| 26 | +### Day 2: First Poll - Primary Role |
| 27 | +**Create a Slack Poll with these exact options**: |
| 28 | + |
| 29 | +**Poll Question**: "What best describes your primary role when working with AboutCode tools?" |
| 30 | + |
| 31 | +**Poll Options** (copy these exactly): |
| 32 | +``` |
| 33 | +🏛️ Compliance/Legal (License compliance, IP management) |
| 34 | +🔒 Security (DevSecOps, Security analysis, Vulnerability research) |
| 35 | +💻 Development (Software engineer, Developer, Architect) |
| 36 | +📊 Management (Product manager, Team lead, CTO) |
| 37 | +🎓 Academic (Student, Researcher, Professor) |
| 38 | +🔧 Operations (QA, Release management, Infrastructure) |
| 39 | +🤝 Procurement (Vendor management, Sourcing) |
| 40 | +🌟 Open Source (Maintainer, Contributor, Community) |
| 41 | +📝 Other (Please specify in thread) |
| 42 | +``` |
| 43 | + |
| 44 | +**Message to accompany the poll**: |
| 45 | +``` |
| 46 | +📊 Poll #1: What's your primary role? |
| 47 | +
|
| 48 | +This helps us understand the different perspectives and needs in our community. Don't see your role listed? Choose "Other" and tell us about it in the thread below! |
| 49 | +
|
| 50 | +Poll stays open for 3 days. Thanks for participating! 🙏 |
| 51 | +``` |
| 52 | + |
| 53 | +### Day 5: Second Poll - Experience Level |
| 54 | +**Poll Question**: "How would you describe your experience level with open source compliance and security tools?" |
| 55 | + |
| 56 | +**Poll Options**: |
| 57 | +``` |
| 58 | +🌱 Beginner (Just getting started) |
| 59 | +📈 Intermediate (Some experience, learning more) |
| 60 | +🎯 Advanced (Experienced, implementing solutions) |
| 61 | +🏆 Expert (Deep expertise, leading initiatives) |
| 62 | +``` |
| 63 | + |
| 64 | +**Message to accompany the poll**: |
| 65 | +``` |
| 66 | +📊 Poll #2: Experience Level |
| 67 | +
|
| 68 | +No judgment here - we want to serve everyone from newcomers to experts! Your experience level helps us create the right mix of content. |
| 69 | +
|
| 70 | +This poll also stays open for 3 days. Keep the responses coming! 🚀 |
| 71 | +``` |
| 72 | + |
| 73 | +## Week 2: Interest Areas and Technical Background |
| 74 | + |
| 75 | +### Day 8: Third Poll - Primary Interest |
| 76 | +**Poll Question**: "What's your primary interest in AboutCode tools?" |
| 77 | + |
| 78 | +**Poll Options**: |
| 79 | +``` |
| 80 | +⚖️ License compliance and legal risk management |
| 81 | +🛡️ Security vulnerabilities and threat analysis |
| 82 | +📦 Software composition analysis and dependencies |
| 83 | +🔍 Code provenance and supply chain transparency |
| 84 | +🤖 Automation and CI/CD integration |
| 85 | +📚 Research and academic study |
| 86 | +🏢 Enterprise governance and policy |
| 87 | +🌐 Open source project management |
| 88 | +``` |
| 89 | + |
| 90 | +**Message to accompany the poll**: |
| 91 | +``` |
| 92 | +📊 Poll #3: Primary Interest Area |
| 93 | +
|
| 94 | +What draws you to AboutCode? Understanding your main focus helps us prioritize which areas to improve first. |
| 95 | +
|
| 96 | +As always, feel free to elaborate in the thread if you have multiple interests or want to share more context! 💬 |
| 97 | +``` |
| 98 | + |
| 99 | +### Day 11: Technical Background Check |
| 100 | +**Message** (not a poll - asking for emoji reactions): |
| 101 | +``` |
| 102 | +🔧 Quick Technical Background Check |
| 103 | +
|
| 104 | +Help us understand the technical diversity of our community! React to this message: |
| 105 | +
|
| 106 | +🔧 - I'm technical (comfortable with APIs, command line, coding) |
| 107 | +📋 - I'm process-focused (more interested in workflows, policies, compliance processes) |
| 108 | +🔀 - I'm both technical and process-focused |
| 109 | +👀 - I'm here to learn (exploring what's possible) |
| 110 | +
|
| 111 | +This helps us balance technical depth with accessibility in our resources. |
| 112 | +``` |
| 113 | + |
| 114 | +## Week 3: Detailed Discussions |
| 115 | + |
| 116 | +### Day 15: Organization Type Discussion |
| 117 | +**Message**: |
| 118 | +``` |
| 119 | +🏢 Organization Type Discussion Thread |
| 120 | +
|
| 121 | +We'd love to know what type of organization you work for/with. This helps us understand different use cases and constraints. |
| 122 | +
|
| 123 | +Reply in this thread with: |
| 124 | +• Enterprise/Large Company |
| 125 | +• Startup/Small Company |
| 126 | +• Government Agency |
| 127 | +• Academic Institution |
| 128 | +• Non-profit Organization |
| 129 | +• Individual Contributor/Freelancer |
| 130 | +• Consulting/Services |
| 131 | +• Other (please specify) |
| 132 | +
|
| 133 | +Feel free to share any context about how your org type affects your AboutCode needs! |
| 134 | +``` |
| 135 | + |
| 136 | +### Day 17: Current Challenges Discussion |
| 137 | +**Message**: |
| 138 | +``` |
| 139 | +🎯 What's Your Biggest Challenge? |
| 140 | +
|
| 141 | +Let's talk about real problems! What's your biggest challenge when it comes to open source compliance, security, or software composition analysis? |
| 142 | +
|
| 143 | +Some examples to get you thinking: |
| 144 | +• "Getting management buy-in for compliance tools" |
| 145 | +• "Integrating scanning into our CI/CD pipeline" |
| 146 | +• "Understanding license compatibility" |
| 147 | +• "Keeping up with vulnerability disclosures" |
| 148 | +• "Scaling analysis across large codebases" |
| 149 | +• "Training team members on compliance processes" |
| 150 | +
|
| 151 | +Share your challenge in this thread - you might find others facing similar issues! 🤝 |
| 152 | +``` |
| 153 | + |
| 154 | +### Day 19: Tool Usage Discussion |
| 155 | +**Message**: |
| 156 | +``` |
| 157 | +🛠️ Which AboutCode Tools Are You Using? |
| 158 | +
|
| 159 | +Help us understand adoption patterns! Reply with which tools you're currently using or most interested in: |
| 160 | +
|
| 161 | +**Current AboutCode Tools:** |
| 162 | +• ScanCode Toolkit |
| 163 | +• ScanCode.io |
| 164 | +• VulnerableCode |
| 165 | +• DejaCode |
| 166 | +• ScanCode Workbench |
| 167 | +• PURLDB |
| 168 | +• Various Inspectors (binary, container, python, etc.) |
| 169 | +• ScanCode LicenseDB |
| 170 | +
|
| 171 | +**Usage Status:** |
| 172 | +✅ Currently using in production |
| 173 | +🧪 Testing/evaluating |
| 174 | +📚 Learning about it |
| 175 | +🎯 Planning to implement |
| 176 | +❓ Want to learn more |
| 177 | +
|
| 178 | +Example: "✅ ScanCode Toolkit, 🧪 ScanCode.io, 📚 VulnerableCode" |
| 179 | +``` |
| 180 | + |
| 181 | +## Week 4: Needs Assessment |
| 182 | + |
| 183 | +### Day 22: Documentation Needs |
| 184 | +**Message**: |
| 185 | +``` |
| 186 | +📚 Documentation Wishlist Thread |
| 187 | +
|
| 188 | +If we could improve our documentation in one area, what would make the biggest difference for you? |
| 189 | +
|
| 190 | +**Types of content we could create:** |
| 191 | +• Step-by-step getting started guides |
| 192 | +• Real-world integration examples |
| 193 | +• Best practices and workflows |
| 194 | +• Compliance process guidance |
| 195 | +• Security analysis tutorials |
| 196 | +• Enterprise deployment guides |
| 197 | +• API documentation improvements |
| 198 | +• Video tutorials/webinars |
| 199 | +• Troubleshooting guides |
| 200 | +• Use case deep-dives |
| 201 | +
|
| 202 | +What's missing that would make your life easier? What format works best for you? |
| 203 | +
|
| 204 | +The more specific, the better! 🎯 |
| 205 | +``` |
| 206 | + |
| 207 | +### Day 24: Feature Priorities Discussion |
| 208 | +**Message**: |
| 209 | +``` |
| 210 | +🎯 Feature Wishlist Thread |
| 211 | +
|
| 212 | +If you could wave a magic wand and improve one thing about AboutCode tools, what would it be? |
| 213 | +
|
| 214 | +**Some areas to consider:** |
| 215 | +• Better UI/UX experience |
| 216 | +• More integrations (which platforms?) |
| 217 | +• Faster performance for large scans |
| 218 | +• Additional vulnerability data sources |
| 219 | +• Improved reporting and dashboards |
| 220 | +• Better automation capabilities |
| 221 | +• Enhanced APIs |
| 222 | +• Mobile/web interfaces |
| 223 | +• Collaboration features |
| 224 | +• Custom policy enforcement |
| 225 | +
|
| 226 | +Dream big! Even "impossible" requests help us understand what you're trying to achieve. 🌟 |
| 227 | +``` |
| 228 | + |
| 229 | +### Day 26: Use Case Stories |
| 230 | +**Message**: |
| 231 | +``` |
| 232 | +📖 Share Your AboutCode Story |
| 233 | +
|
| 234 | +We'd love to hear how you're using (or planning to use) AboutCode tools in your work. Real stories help us understand usage patterns and improve our tools. |
| 235 | +
|
| 236 | +**Tell us about:** |
| 237 | +• What problem are you trying to solve? |
| 238 | +• Which tools are you using or considering? |
| 239 | +• What's working well for you? |
| 240 | +• What's been challenging? |
| 241 | +• Any creative or unexpected use cases? |
| 242 | +
|
| 243 | +Don't worry about length - whether it's a quick sentence or a detailed story, we want to hear it! |
| 244 | +
|
| 245 | +These stories might also help other community members facing similar challenges. 🤝 |
| 246 | +``` |
| 247 | + |
| 248 | +## Week 5: Wrap-up and Next Steps |
| 249 | + |
| 250 | +### Day 29: Thank You and Preview |
| 251 | +**Message**: |
| 252 | +``` |
| 253 | +🙏 Thank You for Your Participation! |
| 254 | +
|
| 255 | +Wow! The response to our user research has been incredible. We've learned so much about our diverse community and your needs. |
| 256 | +
|
| 257 | +**What we're seeing so far:** |
| 258 | +• Amazing diversity in roles and experience levels |
| 259 | +• Strong interest in both compliance and security use cases |
| 260 | +• Need for better getting-started resources |
| 261 | +• Demand for more integration examples |
| 262 | +• Lots of creative use cases we hadn't considered! |
| 263 | +
|
| 264 | +**Next steps:** |
| 265 | +• We're compiling all the feedback (anonymized, of course) |
| 266 | +• Results will inform our 2024 documentation and development priorities |
| 267 | +• We'll share a summary of findings with the community |
| 268 | +• Most importantly - we'll start addressing the gaps you've identified! |
| 269 | +
|
| 270 | +If you haven't had a chance to participate yet, most threads are still open. Every perspective helps! |
| 271 | +
|
| 272 | +Thanks for making AboutCode better for everyone! 🚀 |
| 273 | +``` |
| 274 | + |
| 275 | +### Day 31: Results Summary (Template) |
| 276 | +**Message** (customize based on actual results): |
| 277 | +``` |
| 278 | +📊 User Research Results Summary |
| 279 | +
|
| 280 | +Thanks to everyone who participated in our community research! Here's what we learned: |
| 281 | +
|
| 282 | +**Community Composition:** |
| 283 | +• [X]% Developers/Engineers |
| 284 | +• [X]% Compliance/Legal professionals |
| 285 | +• [X]% Security professionals |
| 286 | +• [X]% Management roles |
| 287 | +• [X]% Academic/Research |
| 288 | +• [And so on...] |
| 289 | +
|
| 290 | +**Top Priorities Identified:** |
| 291 | +1. [Most requested documentation type] |
| 292 | +2. [Most requested feature] |
| 293 | +3. [Most common challenge to address] |
| 294 | +
|
| 295 | +**What We're Doing About It:** |
| 296 | +• [Specific action item 1] |
| 297 | +• [Specific action item 2] |
| 298 | +• [Specific action item 3] |
| 299 | +
|
| 300 | +We'll keep you updated on progress and continue gathering feedback as we grow. This community makes AboutCode better! 🙌 |
| 301 | +
|
| 302 | +Full detailed results will be shared in our documentation repo for anyone interested in the complete analysis. |
| 303 | +``` |
| 304 | + |
| 305 | +## Tips for Implementation |
| 306 | + |
| 307 | +### Before You Start: |
| 308 | +1. **Pin the introduction message** temporarily to increase visibility |
| 309 | +2. **Set calendar reminders** for each message posting |
| 310 | +3. **Prepare to engage** - respond to comments and questions promptly |
| 311 | +4. **Consider time zones** - post during peak activity hours |
| 312 | + |
| 313 | +### During the Process: |
| 314 | +1. **Encourage participation** by responding to early contributors |
| 315 | +2. **Ask follow-up questions** in threads to get more detail |
| 316 | +3. **Thank participants** publicly to encourage others |
| 317 | +4. **Share interesting insights** as they emerge |
| 318 | + |
| 319 | +### Managing the Data: |
| 320 | +1. **Screenshot poll results** before they expire |
| 321 | +2. **Copy thread discussions** to a document for analysis |
| 322 | +3. **Tag themes** as you see patterns emerging |
| 323 | +4. **Keep participant information anonymous** in any summaries |
| 324 | + |
| 325 | +This approach should give you rich, actionable data about your community while building engagement and showing that you value their input! |
0 commit comments