We should definitely codify these floating docs into proper documentation with a couple of case studies