Lego Bricks for Developers: Turning Insights Into Golden Paths
summary
Neo4j builds a library of Lego bricks — single-purpose, opinionated doc templates plus scaffolder recipes — and wires them into Backstage using the Backstage Insights plugin, the scaffolder, Q&A, Grafana, Argo Workflows, and Slack surveys via DX; templates and a “pick up where you left off” reader feature are live, engineers report positive uptake, templates are being open sourced, and the approach helps teams who run over 1,000 Kubernetes clusters standardize and find docs faster.
AI-written summary · about
chapters (17)
- 0:00Introduction and context
- 1:28Understanding golden paths
- 2:26Evaluating current documentation
- 5:06Defining a new framework
- 6:03Measuring user needs
- 7:04Introducing lego bricks
- 10:42Applying dietaxis framework
- 12:23Standardizing document types
- 17:24Improving the reader experience
- 17:50Enhancing UI and engagement
- 18:41Frictionless content creation
- 20:01Improving the writer's journey
- 20:23Short-term improvements
- 20:36Open sourcing and future plans
- 21:29Backstage limitations
- 22:11Summary and key takeaways
- 24:58Questions and answers
related talks
25mThe Lego Approach: Leveraging Reusability for a Seamless...
30mThe LEGO Approach to designing PyData Workflows
27mYellow Brick Code: Lessons from The Wizard of Oz on Enhancing DevEx
59mBecoming API- & Cloud-First at the LEGO Group
11mLightning Talk: The Backstage Builder Experience at Adyen
41mBuilding Your Legos: A Practitioner’s Guide to Reusable Components
22mBuilding Platforms With Empathy and YAML at the LEGO Group
41mBrick by Brick: Building Open Source libraries