#The Shadow DOM Diaries
Feature design is hard, and takes time. With time, it doesn't matter how public and consistent you are with communication during design process. In the end, it all will look like a jumbled mess of emails and bug comments. That seems bad. To make things less bad, I decided to start writing these little docs. Here they are. I may add more. Or not. Whatevs.
Sometimes You Need to Build a Larger Thing First looks back at the road we've traveled.
Shadow DOM Evolution outlines the path forward.
Why Do We Only Allow Children in Insertion Points provides a glimpse into the reasoning behind current insertion point design.