Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Provide "catchy" examples of use of dandi-cli in CLI within README.md #1195

Open
yarikoptic opened this issue Jan 30, 2023 · 1 comment
Open
Labels
documentation Changes only affect the documentation

Comments

@yarikoptic
Copy link
Member

yarikoptic commented Jan 30, 2023

An idea came up within the scope #1193 (comment) by @waxlamp and @melster1010 and IMHO warrants "separate thinking" thus filing a new issue here.

The problem with "more detailed" examples is that they might get outdated even faster than output of --help so it might be important to have them scripted/tested. Here is a few approaches we used/I am aware of

So I decided to try and running

SCREENCAST_HOME=/tmp/demo ./cast2asciinema ../datalad-maint/docs/casts/seamless_nested_repos.sh output.cast

gave me this cast: https://asciinema.org/a/cWrxRnQJlyQNLHg836qAwRbqA (I believe there was some way to turn them also into gifs)

So, if someone were to do some "catchy" interactive demos

smth like that.

@waxlamp
Copy link
Member

waxlamp commented Jan 31, 2023

When you decide what approach you want for testing the doc examples, let us know and if @melster1010 is able to help with that technical writing at that point, she can get into it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Changes only affect the documentation
Projects
None yet
Development

No branches or pull requests

2 participants