Skip to content

chore: ignore local JDK-docs corpus in docs/ (#22) - #29

Open
devops-thiago wants to merge 1 commit into
mainfrom
fix/issue-22-gitignore-docs
Open

chore: ignore local JDK-docs corpus in docs/ (#22)#29
devops-thiago wants to merge 1 commit into
mainfrom
fix/issue-22-gitignore-docs

Conversation

@devops-thiago

Copy link
Copy Markdown
Owner

Summary

  • Add docs/* to .gitignore so the ~326 MB local JDK 25 documentation corpus can never be accidentally committed by a stray git add -A.
  • Keep docs/README.md tracked (via !docs/README.md) to document what the directory is and how to obtain the corpus.
  • The ignore does not affect the existing Docker volume mount (./docs:/app/docs:ro in docker-compose.yml).

Issue

Fixes #22

Test plan

  • git check-ignore docs/ reports the directory as ignored
  • git add -A no longer stages docs/ (dry-run shows only .gitignore, docs/README.md, and the pre-existing untracked docker-compose.e2e.yml — tracked separately in Resolve untracked docker-compose.e2e.yml leftover artifact #25)
  • docs/README.md documents where the corpus comes from and how to ingest it
  • No Java/source files touched — Maven/Spotless gates unaffected

The docs/ directory holds a ~326 MB JDK 25 HTML documentation bundle
provisioned locally (lab VM / Docker volume mount). It was untracked but
not ignored, so a stray `git add -A` could commit it and permanently
bloat the repository.

Ignore docs/* while keeping docs/README.md tracked, and document how to
obtain the corpus.
@thrillhousebot

Copy link
Copy Markdown

🤖 ThrillhouseBot PR Summary

What this PR does

Adds a gitignore rule for the locally provisioned JDK 25 documentation corpus, re-includes docs/README.md so it remains tracked, and documents where the corpus comes from and how to ingest it.

Changes Overview

  • Files changed: 2
  • Lines added: +55
  • Lines removed: 0

Changed Files

File Change Summary
.gitignore Modified Adds docs/* ignore rule with !docs/README.md exception to prevent accidental commits of the JDK docs corpus.
docs/README.md Added Documents the corpus purpose, directory layout, acquisition steps, and RAG ingest commands.

Risk Assessment

Risk Count
🔴 Critical 0
🟠 High 0
🟡 Medium 0
🔵 Low 0

No new issues found in this PR, but the review cannot be approved until CI is confirmed green.

⚠️ CI Checks Status

Some checks are still pending or have failed:

Check Type Status Detail
Build & Test check-run ⏳ Pending -

Automated review by ThrillhouseBot. Reply with /review to re-run.

@thrillhousebot thrillhousebot Bot added the documentation Improvements or additions to documentation label Aug 10, 2026
@sonarqubecloud

Copy link
Copy Markdown

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.

Gitignore docs/ (326 MB untracked JDK docs) to prevent accidental commits

1 participant