docs(extraction): add Customize & extend hub page#2287
Conversation
Add a user-facing customization overview with xrefs to graph, UDF, VDB, and embedding extension guides per doc IA review.
Apply audit fixes: decision table, heading consistency, in-tree starter-kits link, and revert inaccurate 26.05 release-notes claim.
Greptile SummaryThis PR adds a new Customize & extend hub page (
|
| Filename | Overview |
|---|---|
| docs/docs/extraction/customize-extend.md | New hub page introducing four extension paths (task config, UDFs, custom graph, custom VDB) with a decision table and cross-links to repository guides; contains a manual "On this page" TOC heading that will also appear in the Material sidebar auto-TOC. |
| docs/mkdocs.yml | Nav section 8 updated from a bare GitHub link to the new local page; four legacy URL redirects added (two with #fragment anchors, consistent with existing project redirect patterns). |
| docs/docs/extraction/concepts.md | Two cross-links updated to reference the new customize-extend.md hub instead of the bare GitHub graph README URL. |
| docs/docs/extraction/vdbs.md | Two cross-references to customize-extend.md added: one inline in the custom operator paragraph, one in the Related Topics list. |
Flowchart
%%{init: {'theme': 'neutral'}}%%
flowchart TD
NAV["Nav: §8 Customize & extend"]
CE["extraction/customize-extend.md"]
CONCEPTS["concepts.md"]
VDBS["vdbs.md"]
NAV --> CE
CONCEPTS -->|"#job cross-link"| CE
CONCEPTS -->|"#pipeline-and-tasks cross-link"| CE
VDBS -->|"inline + Related Topics"| CE
subgraph Redirects
R1["extraction/user-defined-stages.md"]
R2["extraction/user-defined-functions/index.md"]
R3["extraction/user-defined-functions.md"]
R4["extraction/customize-and-extend.md"]
end
R1 -->|redirect| CE
R2 -->|"redirect → #user-defined-functions-udfs"| CE
R3 -->|"redirect → #user-defined-functions-udfs"| CE
R4 -->|redirect| CE
CE --> TC["#start-with-task-configuration"]
CE --> UDF["#user-defined-functions-udfs"]
CE --> GP["#custom-graph-pipelines"]
CE --> VDB["#custom-vector-databases"]
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
flowchart TD
NAV["Nav: §8 Customize & extend"]
CE["extraction/customize-extend.md"]
CONCEPTS["concepts.md"]
VDBS["vdbs.md"]
NAV --> CE
CONCEPTS -->|"#job cross-link"| CE
CONCEPTS -->|"#pipeline-and-tasks cross-link"| CE
VDBS -->|"inline + Related Topics"| CE
subgraph Redirects
R1["extraction/user-defined-stages.md"]
R2["extraction/user-defined-functions/index.md"]
R3["extraction/user-defined-functions.md"]
R4["extraction/customize-and-extend.md"]
end
R1 -->|redirect| CE
R2 -->|"redirect → #user-defined-functions-udfs"| CE
R3 -->|"redirect → #user-defined-functions-udfs"| CE
R4 -->|redirect| CE
CE --> TC["#start-with-task-configuration"]
CE --> UDF["#user-defined-functions-udfs"]
CE --> GP["#custom-graph-pipelines"]
CE --> VDB["#custom-vector-databases"]
Reviews (5): Last reviewed commit: "Merge branch 'main' into docs/customize-..." | Re-trigger Greptile
Co-authored-by: Randy Gelhausen <rgelhau@gmail.com>
Per review: remove example notebook and starter-kit links until examples are refreshed; keep graph README and source-doc references.
Summary
eleasenotes.md, and \�dbs.md.
Follow-up to Randy's doc IA feedback (separate from #2276 starter-kits work).
Test plan
Related