Bug Bashing Your Docs

on YouTube ↗05m

" summary

Gamified bug bashes claim to boost participation and visibility for docs by having people file bugs in Jira labels with a simple 4/2/1 point system, awarding low‑cost prizes like gift cards or schwag, and running timeboxed sprints (week to month). Success depends on concrete rules: inclusion/exclusion criteria, timestamp tie‑breakers, minimum quality for full points, fast triage, manager buy‑in and a contact channel such as the documentation Slack channel. Samsung runs this virtually and repeats it quarterly.

AI-written summary · about

" chapters (7)

1. 0:00Start
2. 1:24Prizes
3. 1:59Inclusion and Exclusion Criteria
4. 2:45Submission System
5. 3:11Scoring System Example
6. 4:18Rinse and Repeat
7. 4:31Triage the Bugs

" related talks

• 17mTransform your bug bash into an AWS BugBustAdnan Bilwani · AWS Summit Online – Americas 2021
• 40mThe art of asking questionsJakob Sloth-Brodersen · Øredev 2023
• 20mDo Docs Better: Practical Tips on Delivering...Riona MacNamara · SREcon18 Asia/Australia
• 10mCan we NOT do docs at the eleventh hour? Mmmmmaybe.Abi Sutherland · Write the Docs Prague 2022
• 38mManaging for Success: Maintaining a Healthy Bug Bounty Program Long TermChloe Brown · Black Hat USA 2019
• 23mMaster JIRA APIs: Essential Documentation TipsSzymon Ozimek · Apidays Helsinki & North 2023
• 26mJust-In-Time Documentation: Employing Agile Methodology To Create Living DocumentationBrianne Hillmer · Write the Docs North America 2016
• 37mTaking a step back: Analysing your documentationLana Brindley · linux.conf.au 2021