Skip to content

docs: add GIF demo to README for better visualization#61

Merged
naheel0 merged 4 commits intoBeyteFlow:mainfrom
mahek395:main
Mar 25, 2026
Merged

docs: add GIF demo to README for better visualization#61
naheel0 merged 4 commits intoBeyteFlow:mainfrom
mahek395:main

Conversation

@mahek395
Copy link
Copy Markdown
Contributor

@mahek395 mahek395 commented Mar 24, 2026

Closes #57
Closes #60

Changes made:

  1. Added two GIF demos to README:

    • errlens run intercepting a TypeError → assets/errlens-run.gif
    • errlens analyze for manual error analysis → assets/errlens-analyze.gif
  2. Documented --lang CLI option:

    • Added usage examples for run and analyze with --lang
    • Added supported languages table (en, hi, es, fr, de, zh, ja, pt)
    • Documented default behavior (English when --lang not specified)
    • Added tip for combining --lang with --json

Recording setup:

  • Recorded using ScreenToGif (Windows)
  • Terminal: VS Code integrated PowerShell
  • GIFs optimized and resized to 800px using ezgif.com

Summary by CodeRabbit

  • Documentation
    • Added live demo section with visual examples of errlens run and errlens analyze commands
    • Expanded quick start guide with multilingual examples
    • New dedicated section documenting multilingual support
    • Added language reference table for 8 supported languages: English, Hindi, Spanish, French, German, Chinese, Japanese, and Portuguese

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Mar 24, 2026
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 24, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 6ed34a96-bb2f-4be2-9655-37e2df258cc6

📥 Commits

Reviewing files that changed from the base of the PR and between 40f4812 and 2d10451.

📒 Files selected for processing (1)
  • README.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • README.md

📝 Walkthrough

Walkthrough

README updated with a "🎬 Live Demo" section (two GIFs) and a new "4️⃣ Multilingual Support" section documenting the --lang flag and supported language codes; no code or public API changes.

Changes

Cohort / File(s) Summary
Documentation
README.md
Inserted "🎬 Live Demo" with two GIFs showing errlens run test.js and errlens analyze "..."; expanded "⚡ Quick Start" examples to include --lang usage (--lang hi, --lang es); added "4️⃣ Multilingual Support" section describing --lang (default en) and supported languages list: en, hi, es, fr, de, zh, ja, pt.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

Suggested labels

cli

Suggested reviewers

  • jaseel0

Poem

🐰
GIFs hop, pixels giggle and play,
ErrLens explains errors in a lively display,
Tongues of many colors line the page,
A tiny demo takes the stage,
Hooray — the README cheers today! 🥕🎬

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly focuses on adding GIF demos to README, which aligns with the main objective of improving visualization, though the PR also includes substantial documentation of the --lang feature.
Linked Issues check ✅ Passed The PR addresses all requirements from issues #57 and #60: GIF demos for errlens run and errlens analyze, documentation of --lang option with usage examples, supported languages table, and default behavior documentation.
Out of Scope Changes check ✅ Passed All changes in the PR are directly scoped to documentation improvements required by linked issues #57 and #60; no unrelated code or feature modifications are present.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🧹 Nitpick comments (1)
README.md (1)

39-39: Use an H2 for the new “Live Demo” section to keep heading hierarchy valid.

Line 39 jumps to ### without a parent ##, which triggers MD001 and can hurt markdown navigation consistency. Please change it to ## 🎬 Live Demo.

Proposed fix
-### 🎬 Live Demo
+## 🎬 Live Demo
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` at line 39, The "Live Demo" section heading in README.md is using
a third-level heading ("### 🎬 Live Demo") which breaks the heading hierarchy
(MD001); change it to a second-level heading by replacing "### 🎬 Live Demo"
with "## 🎬 Live Demo" so the section has the correct parent level and restores
proper markdown navigation/TOC behavior.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@README.md`:
- Line 39: The "Live Demo" section heading in README.md is using a third-level
heading ("### 🎬 Live Demo") which breaks the heading hierarchy (MD001); change
it to a second-level heading by replacing "### 🎬 Live Demo" with "## 🎬 Live
Demo" so the section has the correct parent level and restores proper markdown
navigation/TOC behavior.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 70c054fc-f726-474f-a2b2-18c73b83a69d

📥 Commits

Reviewing files that changed from the base of the PR and between 38979ed and a075c87.

⛔ Files ignored due to path filters (2)
  • assets/errlens-analyze.gif is excluded by !**/*.gif
  • assets/errlens-run.gif is excluded by !**/*.gif
📒 Files selected for processing (1)
  • README.md

Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
README.md (1)

81-87: Consider documenting the --lang flag in the "Available Commands" section.

The new multilingual examples demonstrate the --lang flag, but it's not mentioned in the "Available Commands" section (lines 96-99). For completeness, consider adding the flag to the command syntax documentation.

📝 Suggested addition to Available Commands section

Update lines 96-97 to include the --lang flag:

-errlens run <file> [--json]       # Run a script and analyze any crashes
-errlens analyze <error> [--json]  # Analyze a specific error message
+errlens run <file> [--json] [--lang <code>]       # Run a script and analyze any crashes
+errlens analyze <error> [--json] [--lang <code>]  # Analyze a specific error message
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 81 - 87, Add documentation for the new --lang CLI
flag to the "Available Commands" section by updating its command syntax examples
to show the optional --lang <code|en|es|hi|...> parameter and a brief one-line
description; specifically modify the "Available Commands" section (where other
CLI flags are listed) to include the --lang flag and an example like errlens
analyze <query> --lang <lang> so readers see its usage alongside existing
commands.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@README.md`:
- Around line 209-212: The README tip contains an unclosed code fence for the
bash example; locate the tip with the command snippet (errlens analyze "is not a
function" --lang fr --json) and add the missing closing triple backticks to
properly terminate the fenced code block so the markdown renders correctly.
- Line 39: Change the markdown heading "### 🎬 Live Demo" to use h2 instead of
h3 so it increments correctly from the top-level h1 title; locate the "### 🎬
Live Demo" heading in README.md and replace it with "## 🎬 Live Demo" to conform
to proper heading level sequencing.

---

Nitpick comments:
In `@README.md`:
- Around line 81-87: Add documentation for the new --lang CLI flag to the
"Available Commands" section by updating its command syntax examples to show the
optional --lang <code|en|es|hi|...> parameter and a brief one-line description;
specifically modify the "Available Commands" section (where other CLI flags are
listed) to include the --lang flag and an example like errlens analyze <query>
--lang <lang> so readers see its usage alongside existing commands.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ae0c0472-dbc1-40f8-b487-acb13fc399a7

📥 Commits

Reviewing files that changed from the base of the PR and between a075c87 and 40f4812.

📒 Files selected for processing (1)
  • README.md

@naheel0 naheel0 merged commit a82121e into BeyteFlow:main Mar 25, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update README to document --lang CLI option Add GIF demo to README for better visualization

2 participants