Skip to content

refactor(ai): sync the ai doc/structure - #409

Merged
imbajin merged 7 commits into
apache:masterfrom
YoungHypo:fix-first-line-indent
Jul 2, 2025
Merged

refactor(ai): sync the ai doc/structure#409
imbajin merged 7 commits into
apache:masterfrom
YoungHypo:fix-first-line-indent

Conversation

@YoungHypo

Copy link
Copy Markdown
Contributor

In the content/cn/docs/quickstart/hugegraph-ai/_index.md, the first-line front matter is not properly indented, resulting in rendering issues and layout problems on the documentation page. This PR includes a fix by checking and correcting the indentation of the document.

before:
Screenshot 2025-06-26 at 8 14 54 PM

now:
Screenshot 2025-06-26 at 8 15 46 PM

@dosubot dosubot Bot added size:L This PR changes 100-499 lines, ignoring generated files. bug Something isn't working labels Jun 27, 2025
@imbajin
imbajin requested a review from Copilot July 2, 2025 08:35

Copilot AI 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.

Pull Request Overview

Aligns and standardizes markdown indentation in the Chinese quickstart for HugeGraph-AI to resolve rendering issues.

  • Fix list item markers and nesting under ordered steps.
  • Normalize indentation for code fences across Docker and source-build instructions.
  • Ensure consistent formatting in examples and tip blocks.
Comments suppressed due to low confidence (2)

content/cn/docs/quickstart/hugegraph-ai/_index.md:66

  • This line is a nested point under step 1 but lacks a list marker. Consider adding - before the text or adjusting indentation so it renders as part of the list.
   有一个使用 docker 的简单方法:  

content/cn/docs/quickstart/hugegraph-ai/_index.md:107

  • These link lines under step 7 are not marked as list items, which may break the nested list. Add - before each or indent appropriately to maintain the list structure.
   [hugegraph-hubble](/docs/quickstart/toolchain/hugegraph-hubble/#21-use-docker-convenient-for-testdev) 

Comment thread .gitignore Outdated

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

THX, We already updated the doc yesterday & I will sync it now

imbajin added 2 commits July 2, 2025 16:38
Rewrote and streamlined the HugeGraph-AI quickstart documentation for clarity, highlighting key features, modules, and usage examples. Added a new 'hugegraph-llm.md' with detailed environment setup, Docker/source installation, and code examples for knowledge graph construction and RAG. Enabled Mermaid.js in config.toml with a note to upgrade Docsy for full support.
@dosubot dosubot Bot added size:XL This PR changes 500-999 lines, ignoring generated files. and removed size:L This PR changes 100-499 lines, ignoring generated files. labels Jul 2, 2025
Majorly rewrote and reorganized the hugegraph-llm.md documentation for clarity, modern deployment options, and improved usage examples. Added Docker Compose instructions, clarified prerequisites, and enhanced code and workflow examples. Adjusted document weights to prioritize the main HugeGraph-LLM guide over the UI details.
@imbajin imbajin changed the title fix: hugegraph-ai chinese document rendering exception refactor(ai): sync the ai doc/structure Jul 2, 2025
Updated the HugeGraph-AI quickstart index with a more concise, modular overview, deployment instructions, and usage examples. Added a new detailed Chinese guide for HugeGraph-LLM, covering features, setup, and code samples. Adjusted the quick_start.md weight for navigation consistency.
@dosubot dosubot Bot added size:XXL This PR changes 1000+ lines, ignoring generated files. and removed size:XL This PR changes 500-999 lines, ignoring generated files. labels Jul 2, 2025
@imbajin

imbajin commented Jul 2, 2025

Copy link
Copy Markdown
Member

TODO: (Merge current PR first)
we need support mermaid.js module for it
image

refer #408

@dosubot dosubot Bot added the lgtm This PR has been approved by a maintainer label Jul 2, 2025
@imbajin
imbajin merged commit 3e1c610 into apache:master Jul 2, 2025
1 check passed
github-actions Bot pushed a commit that referenced this pull request Jul 2, 2025
* Refactor HugeGraph-AI quickstart docs and add LLM guide

---------

Co-authored-by: imbajin <jin@apache.org> 3e1c610
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working lgtm This PR has been approved by a maintainer size:XXL This PR changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants