Skip to content

Conversation

petecheslock
Copy link
Collaborator

The update introduces a robust architecture for automatically syncing documentation from remote GitHub repositories, ensuring that the site always reflects the latest information from source projects.

The remote content system now features a modular structure, with clear separation between architecture, guide, and community content sources. Each content source is configured for automatic transformation, attribution, and integration into the Docusaurus site.

The README for the remote content system has been thoroughly updated to include detailed mermaid diagrams that visually explain the flow of content from remote repositories through transformation utilities and into the final documentation.

The documentation now provides a comprehensive overview of the system’s architecture, the transformation pipeline, and clear instructions for adding new content sources or components.

Additionally, the update streamlines the process for contributors by clarifying the steps required to add or update remote content, and by providing troubleshooting guidance for common issues.

Copy link

netlify bot commented Jul 31, 2025

Deploy Preview for elaborate-kangaroo-25e1ee ready!

Name Link
🔨 Latest commit 5233f5b
🔍 Latest deploy log https://app.netlify.com/projects/elaborate-kangaroo-25e1ee/deploys/688be5458247a90008839579
😎 Deploy Preview https://deploy-preview-72--elaborate-kangaroo-25e1ee.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

- Updated .gitignore to exclude new architecture and component documentation files.
- Expanded CONTRIBUTING.md with detailed guidelines for contributing to the llm-d website, including a quick guide for documentation changes and types of content.
- Modified docusaurus.config.js to correct links for architecture documentation.
- Added new remote content integration for architecture and component documentation, allowing automatic syncing from the main llm-d repository.
- Removed outdated local documentation files to streamline content management.

Signed-off-by: Pete Cheslock <[email protected]>
- Updated CONTRIBUTING.md to clarify directory structure for new content types and provided examples for copying templates.
- Expanded remote-content/README.md with detailed instructions on content organization and configuration.
- Introduced new remote content sources for architecture, community, and guide documentation, allowing for automatic syncing from the llm-d repository.
- Added multiple new files for community guidelines, security policies, and various guide topics to improve documentation accessibility.

Signed-off-by: Pete Cheslock <[email protected]>
- Renamed and unified transformation functions to ensure all relative links point back to the source repository.
- Updated documentation comments for clarity and accuracy.
- Deprecated previous transform functions in favor of a single, cohesive implementation.

Signed-off-by: Pete Cheslock <[email protected]>
…rams

- Added a comprehensive overview of the Remote Content Plugin System, including file organization and processing flow.
- Introduced mermaid diagrams to illustrate the system architecture and detailed content transformation steps.
- Expanded documentation to clarify the auto-generation of component documentation and integration with Docusaurus.

Signed-off-by: Pete Cheslock <[email protected]>
- Introduced a new remote content source for the precise prefix cache aware guide, enabling automatic fetching and transformation of the README.md from the llm-d-infra repository.
- Updated remote-content.js to include the new source in the plugin system.

Signed-off-by: Pete Cheslock <[email protected]>
- Updated the `fixImages` function to accept a `sourceDir` parameter, allowing for correct resolution of relative paths based on the source file's directory.
- Modified the `transformRepo` function to pass the `sourcePath` to the image and link transformation functions, ensuring all relative links point accurately to the source repository.
- Adjusted content transformation logic in the guide examples to accommodate the new `sourcePath` parameter.

Signed-off-by: Pete Cheslock <[email protected]>
@petecheslock petecheslock force-pushed the feat/architecture-update branch from f6ae045 to df687fa Compare July 31, 2025 21:23
@petecheslock
Copy link
Collaborator Author

@jjasghar checking this branch - using the link checker the only broken links its showing are going to be fixed when we merge in this PR llm-d-incubation/llm-d-infra#134 - So this is ready to go.

Copy link
Collaborator

@jjasghar jjasghar left a comment

Choose a reason for hiding this comment

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

Ok, this looks fine but it's a huge rearchitecture. I'll approve it, because it looks like it works :)

@jjasghar jjasghar merged commit 3f483d5 into llm-d:main Aug 1, 2025
5 checks passed
@petecheslock petecheslock deleted the feat/architecture-update branch August 1, 2025 17:56
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