Skip to content

docs: remove libgit2 from the gitextractor setup - #838

Merged
Startrekzky merged 1 commit into
mainfrom
docs/gitextractor-git-cli
Nov 1, 2026
Merged

Startrekzky merged 1 commit into
mainfrom
docs/gitextractor-git-cli

Conversation

@klesh

@klesh klesh commented Nov 1, 2026

Copy link
Copy Markdown
Contributor

Summary

The DevLake backend no longer uses libgit2 or go-git: gitextractor reads repositories with the git command line (apache/devlake#9293). Update the documentation accordingly.

  • docs/Plugins/gitextractor.md: remove the libgit2 1.3.0 / cmake / PKG_CONFIG_PATH build guide for Linux and macOS, and replace it with the git 2.31+ requirement. Also fix the standalone-mode command, which pointed at main.go and used the removed -id and -db flags (the DB now comes from .env/DB_URL).
  • docs/DeveloperManuals/DeveloperSetup.md: add Git 2.31+ to Requirements, replace the "install plugin dependencies (RefDiff)" step with the git requirement, and replace the libgit2.so.1.3 troubleshooting entry with a git: executable file not found one.
  • docs/Plugins/refdiff.md: remove the "depends on libgit2" Development section. RefDiff does not use libgit2 directly.
  • docs/Troubleshooting/Configuration.md: IN_SECURE_SKIP_VERIFY=true now also disables TLS verification for the git clone (GIT_SSL_NO_VERIFY=true); the root-CA approach is still recommended.

versioned_docs/ is intentionally untouched: those pages document released versions that did use libgit2.

Does this close any open issues?

N/A

Screenshots

N/A

Other Information

Docs only; the site build is left to CI.

gitextractor now reads repositories with the git command line, so the
libgit2 build guide, pkg-config/LD_LIBRARY_PATH instructions and the
libgit2 troubleshooting entries no longer apply. Document the git 2.31+
requirement instead and update the standalone-mode command.

RefDiff does not depend on libgit2 either, so its Development section is
removed. versioned_docs for released versions are left untouched.

@Startrekzky Startrekzky left a comment

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.

LGTM

@Startrekzky
Startrekzky merged commit aa10f36 into main Nov 1, 2026
1 check passed
@Startrekzky
Startrekzky deleted the docs/gitextractor-git-cli branch November 1, 2026 11:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type/documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants