Skip to content

docs: refine README install flow and devtool section#656

Merged
luoliwoshang merged 8 commits into
xgo-dev:mainfrom
luoliwoshang:readme-llgo-main-pipeline
Feb 14, 2026
Merged

docs: refine README install flow and devtool section#656
luoliwoshang merged 8 commits into
xgo-dev:mainfrom
luoliwoshang:readme-llgo-main-pipeline

Conversation

@luoliwoshang
Copy link
Copy Markdown
Contributor

Summary

  • update the README install section to clarify that the llcppg package-generation pipeline is fully compiled by LLGo
  • clarify that llcppg currently follows LLGo main branch behavior
  • keep the minimal required install command for normal usage:
    • llgo install ./cmd/llcppg
  • move optional standalone tools into a separate devtool subsection under How to install:
    • llgo install ./_xtool/llcppsymg
    • llgo install ./_xtool/llcppsigfetch
    • llgo install ./cmd/gogensig
    • go install ./cmd/llcppcfg

Scope

Documentation-only update. No code behavior changes.

@gemini-code-assist
Copy link
Copy Markdown
Contributor

Summary of Changes

Hello @luoliwoshang, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request focuses on enhancing the clarity and organization of the README.md file. It refines the installation instructions for the llcppg tool, making it easier for users to understand the core installation process versus optional development tools. The changes improve the overall user experience by providing a more structured and informative guide without altering any code functionality.

Highlights

  • Installation Flow Clarification: The README's installation section has been updated to explicitly state that the llcppg package-generation pipeline is fully compiled by LLGo.
  • LLGo Main Branch Behavior: Clarified that llcppg currently aligns with the behavior of the LLGo main branch.
  • Streamlined Core Installation: The minimal required installation command for normal usage (llgo install ./cmd/llcppg) is now more prominent and distinct.
  • Dedicated Devtool Section: Optional standalone development tools (llcppsymg, llcppsigfetch, gogensig, llcppcfg) have been moved into a new, separate devtool subsection under 'How to install' for better organization.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Changelog
  • README.md
    • Updated the 'How to install' section to clarify the llcppg installation process.
    • Introduced a new 'devtool' subsection to group optional debugging and troubleshooting tools.
    • Reordered content to emphasize the primary llcppg installation command.
Activity
  • No specific activity or comments have been recorded for this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown
Contributor

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request improves the clarity of the installation instructions in the README by separating the main tool installation from the optional development tools. The new structure is much easier to follow. I have one minor suggestion to improve consistency in the section headings.

Comment thread README.md Outdated
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
@fennoai
Copy link
Copy Markdown
Contributor

fennoai Bot commented Feb 14, 2026

Clean separation of the required install from the optional dev tools. Two minor issues: the ### devtool heading uses lowercase, inconsistent with every other heading in the README (e.g., ### Generated Bindings, ### Development Tools). Also, there's already a ### Development Tools section at line 459 — the similar naming could confuse readers. Consider renaming one of them to disambiguate.

Comment thread README.md
Comment on lines 37 to 39
```

For normal package generation, only the `llcppg` binary is required.
The standalone tools above are kept mainly for debugging and isolated troubleshooting.


Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Nit: there's a double blank line here before ## Usage. One blank line is sufficient.

Suggested change
```
For normal package generation, only the `llcppg` binary is required.
The standalone tools above are kept mainly for debugging and isolated troubleshooting.

Comment thread README.md

For normal package generation, only the `llcppg` binary is required.

### Development tools
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Heading capitalization is inconsistent with the rest of the README (e.g., ### Generated Bindings, ### Development Tools). Also, there's already a ### Development Tools section later in the file (line 459). Consider capitalizing this and making the name more distinct, e.g.:

Suggested change
### Development tools
### Dev Tools (Optional)

@codecov
Copy link
Copy Markdown

codecov Bot commented Feb 14, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 83.32%. Comparing base (9a90d16) to head (6595fca).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #656   +/-   ##
=======================================
  Coverage   83.32%   83.32%           
=======================================
  Files          28       28           
  Lines        2501     2501           
=======================================
  Hits         2084     2084           
  Misses        369      369           
  Partials       48       48           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@luoliwoshang luoliwoshang merged commit a32d1c4 into xgo-dev:main Feb 14, 2026
11 of 12 checks passed
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.

2 participants