Skip to content

docs: correct built-in KB dump list and collection-name guidance#23

Merged
chideat merged 1 commit into
release-1.4from
docs/fix-builtin-kb-dump-list
May 27, 2026
Merged

docs: correct built-in KB dump list and collection-name guidance#23
chideat merged 1 commit into
release-1.4from
docs/fix-builtin-kb-dump-list

Conversation

@chideat
Copy link
Copy Markdown

@chideat chideat commented May 27, 2026

What

Fixes inaccuracies in the v1.4 install/upgrade docs, all tracing to the obsolete cs2000/cs3000 dump naming. Verified against the release-1.4 chart in alauda/aml/smart-doc.

docs/en/install.mdx

  • Built-in KnowledgeBase File — the selector listed two non-existent dumps described by chunk size. charts/smart-doc/scripts/plugin-config.yaml actually offers three dumps keyed to ACP documentation version, defaulting to acp_4_3:
    • docvec_gte_acp_4_1_20260508.dump — ACP 4.1 corpus
    • docvec_gte_acp_4_2_20260508.dump — ACP 4.2 corpus
    • docvec_gte_acp_4_3_20260508.dump (default) — ACP 4.3 corpus
  • PG collection name — the old "don't change it" advice was incomplete. The name must match the selected dump's internal collection name (filename without .dump). Because the first-start restore (init-database.sh:20-30) loads the dump without renaming the collection, picking a non-default dump while leaving the collection name at its acp_4_3 default silently breaks retrieval. Added a NOTE.

docs/en/upgrade/index.mdx

  • Example swap-log line showed the stale final name=docvec_gte_cs2000_20260410; the script prints ${PG_COLLECTION_NAME} (default docvec_gte_acp_4_3_20260508). Corrected.

Verification

  • Selector / default: plugin-config.yaml:221-224, values.yaml:150
  • Collection-name rule: values.yaml:77-80, plugin-config.yaml:200
  • First-start no-rename behavior: files/init-database.sh:20-30
  • Dump → ACP version mapping: builder/data/repos-acp-4.{1,2,3}-*.json kb_version
  • No cs2000/cs3000 references remain anywhere under docs/

🤖 Generated with Claude Code

The install form's "Built-in KnowledgeBase File" selector listed two
obsolete dumps (docvec_gte_cs2000/cs3000, described by chunk size). The
v1.4 chart (plugin-config.yaml) actually offers three dumps keyed to ACP
documentation version, defaulting to acp_4_3:
  - docvec_gte_acp_4_1_20260508.dump (ACP 4.1)
  - docvec_gte_acp_4_2_20260508.dump (ACP 4.2)
  - docvec_gte_acp_4_3_20260508.dump (ACP 4.3, default)

Also fix the "PG collection name" guidance: it must match the selected
dump's internal collection name (filename without .dump). Since the
first-start restore loads the dump as-is without renaming the collection
(init-database.sh), selecting a non-default dump while leaving the
collection name at its acp_4_3 default silently breaks retrieval. Added a
NOTE covering this.

Fix the same stale cs2000 name in the upgrade doc's example swap log
(final name is PG_COLLECTION_NAME, default docvec_gte_acp_4_3_20260508).
Copilot AI review requested due to automatic review settings May 27, 2026 07:46
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 27, 2026

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (3)
  • main
  • master
  • ^\d.x$

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 1c9f1e76-b74d-4ae5-990a-5e520dbf2a10

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/fix-builtin-kb-dump-list

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

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR corrects v1.4 installation and upgrade documentation for the bundled knowledge base dump names and the required PGVector collection-name relationship.

Changes:

  • Replaces obsolete cs2000/cs3000 dump references with ACP 4.1/4.2/4.3 built-in dump options.
  • Clarifies that PG collection name must match the selected dump filename without .dump.
  • Updates the upgrade verification log example to show the current default final collection name.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
docs/en/install.mdx Updates install guidance for built-in KB dump selection and PG collection naming.
docs/en/upgrade/index.mdx Corrects the sample upgrade swap log output.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying alauda-hyperflux with  Cloudflare Pages  Cloudflare Pages

Latest commit: c014c03
Status: ✅  Deploy successful!
Preview URL: https://3f249a7a.alauda-hyperflux.pages.dev
Branch Preview URL: https://docs-fix-builtin-kb-dump-lis.alauda-hyperflux.pages.dev

View logs

@chideat chideat merged commit dd5af3c into release-1.4 May 27, 2026
4 checks passed
@chideat chideat deleted the docs/fix-builtin-kb-dump-list branch May 27, 2026 08:23
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