openlab-cli icon indicating copy to clipboard operation
openlab-cli copied to clipboard

improvement: autorecord example workflows

Open blahah opened this issue 2 years ago • 1 comments

oclif already allows for including example commands in command classes, and we use these to render the interface documentation.

We previously produced some animated recordings of workflows with the CLI and had overwhelmingly positive feedback.

We should use the tooling introduced in #21, like the cli.api.json interface definition, and the docs/render.js script, to generate recorded examples from the code at build time. This will mean we always have nice up to date workflow recordings, which is great for users. It also means we can quickly check the workflow recordings to make sure all the key workflows are behaving as expected, as part of code review.

blahah avatar Jul 05 '22 12:07 blahah

really great idea - I think animations about the tool functionality are going to be key for scientific user adoption

NiklasTR avatar Jul 05 '22 12:07 NiklasTR