Any supriya users here?

And just to add - writing docs is tough, and I made it a little tougher on myself. Supriya’s doc system actually runs all code examples in a sub-interpreter, capturing the output (including any audio or images) into the resulting HTML. Makes it tricky because I have to craft a narrative that makes sense from the top of a help page to the bottom, and explicitly safe-list any exceptions that might arise. Can’t introduce concepts without importing them, can’t reference variables without declaring them etc. Guarantees the docs only refer to working code, but also obligates me to only write and maintain working code in the docs.

2 Likes