Rewrote HockeyStack docs to match product reality
By RepoJournal , from @bgrgndzz's public GitHub activity
Backfilled
1 person shipped this
Buğra Gündüz overhauled the HockeyStack documentation across 10 commits, removing fabricated UI details, restructuring scoring and stakeholder discovery guides, and adding new reference material for sales views and user roles.
The work began with removing false claims embedded in the docs. The stakeholder-discovery guide claimed a Settings page with per-view toggles that does not exist [1]. The company-agent and tasks pages described UI elements that were never built [1]. These were replaced with the actual product flows: stakeholder mapping is now configured from the Personas modal's Stakeholder Mapping tab, not the sales view dropdown [2].
Buğra then added comprehensive documentation for core features that lacked it. A full Delphi scoring guide went live covering score types, the creation wizard, behavior configuration, CRM sync, conversion tracking, and reasoning [3]. The getting started guide gained a new Step 7 for scoring setup, renumbering everything that came after [4]. A guide on choosing signals for prospecting motions clarified that the Signals tab should hold timing and context properties for personalization, while fit properties belong in Account Segments [5].
Three separate fixes aligned the docs with the product UI. The labels "Enum" were changed to "Dropdown" to match what users actually see [7]. The daily/weekly refresh policy selector became a "Refresh Every (days)" number input [7]. Scoring and stakeholder discovery were removed from the optional steps list [6].
New reference material landed too. An AI property examples library organized ready-to-use configs by category: timing signals like funding and hiring, context signals like tech stack and competitors, fit signals like ICP score and revenue range, and industry-specific examples for DevTools, Marketing, and Sales [8]. A fresh Sales Views page documented view creation, filters, table columns, and how views connect to scoring and stakeholder discovery [9]. A Users and Roles page was added and linked from Getting Started and Team [10].
One email a day. Unsubscribe in one click.
A short briefing every day bgrgndzz ships something — in about 3 minutes.
One email a day. Unsubscribe in one click. Read a past issue →
References
- [1] fix: remove fabricated UI details from docs HockeyStack/mintlify-docs
- [2] docs: rewrite stakeholder discovery to match Atlas > Personas > Stakeholder Mapping flow HockeyStack/mintlify-docs
- [3] docs: add Delphi scoring documentation HockeyStack/mintlify-docs
- [4] docs: add scoring step to getting started guide HockeyStack/mintlify-docs
- [5] docs: add guidance on choosing signals for prospecting motions HockeyStack/mintlify-docs
- [6] fix: remove 'optional' from scoring and stakeholder discovery steps HockeyStack/mintlify-docs
- [7] fix: correct AI property UI labels across all docs HockeyStack/mintlify-docs
- [8] docs: add AI property examples library HockeyStack/mintlify-docs
- [9] docs: add Sales Views documentation HockeyStack/mintlify-docs
- [10] docs: add Users and Roles page, link from Getting Started and Team HockeyStack/mintlify-docs
