[joshcanhelp]

I totally agree. This would not work well with a large body of documentation and has some big limitations in terms of formatting.

I never got to my second spike but I was looking at maintaining separate code files that could be included and tested atomically. That model was based on how we were trying to do it at a previous position using Contentful for the content management and then pointing code samples to publicly-available files.