Skip to content

Enhance project approachability with embedded CLI demo (SVG) - #7

Open
taowox wants to merge 1 commit into
cchalop1:mainfrom
taowox:docs/cli-documentation-1752502168328
Open

Enhance project approachability with embedded CLI demo (SVG)#7
taowox wants to merge 1 commit into
cchalop1:mainfrom
taowox:docs/cli-documentation-1752502168328

Conversation

@taowox

@taowox taowox commented Jul 14, 2025

Copy link
Copy Markdown

Hello!

I’ve been exploring your CLI project and wanted to help make it easier for users to understand and use. This PR sets up DeepGuide, a tool for recording interactive terminal demos directly in your README.

What this PR does

  • Adds a .dg/ config directory and GitHub Actions workflow to your repo for demo recording and CI validation.

  • No changes to your CLI code itself, only prepares your repo to capture demos.

Next steps for you

After merging, DeepGuide is installed and configured. You can start recording demos by running:

npx @deepguide-ai/dg doctor
npx @deepguide-ai/dg capture

This generates interactive SVG demos that you can embed in your README or documentation. Commit these changes to update your docs with live, interactive examples.

Why use DeepGuide CLI?

  • Make your CLI usage easier to follow with interactive, up-to-date demos.

  • Avoid stale GIFs or static code blocks.

  • Automatically validate demos in CI to keep docs accurate.

Adds DeepGuide scaffold files to enable interactive terminal demonstrations:
- Configuration setup (.dg/config.json)
- CI validation workflow
- Documentation updates
- Git ignore patterns for demo assets

No source code changes - purely additive setup for future demos.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant