Using iterative design docs

One of the engineers on our team wrote this post describing how we've replaced static design docs with something more iterative:

https://lightstep.com/blog/how-we-write-code-at-lightstep-lab-notebooks/

So far it's been a generally positive experience, but I'm curious if others have tried similar approaches and had any thoughts on it.