Open amimart opened 2 hours ago
The latest updates on your projects. Learn more about Vercel for Git ↗︎
Name | Status | Preview | Comments | Updated (UTC) |
---|---|---|---|---|
docs | ✅ Ready (Inspect) | Visit Preview | 💬 Add feedback | Oct 11, 2024 3:04pm |
The configuration for the documentation generation workflow in .github/workflows/generate-doc-bundles.yml
has been updated to change the source files for the "whitepaper-tech-faq" documentation bundle. The previous source path for technical documentation has been replaced with a new path that focuses on architecture-related documentation. The overall structure of the workflow remains unchanged, with no modifications to job definitions or other configurations.
File | Change Summary |
---|---|
.github/workflows/generate-doc-bundles.yml | Updated source path for the "whitepaper-tech-faq" documentation bundle from docs/technical-documentation/**/*.md to docs/architecture/**/*.md . |
In the land of code where rabbits dwell,
A path was changed, oh what a spell!
From tech to arch, the docs now sing,
A bundle of wisdom, a joyful thing.
Hops of delight in every line,
Our workflow's bright, how it does shine! 🐇✨
.github/workflows/generate-doc-bundles.yml (2)
Line range hint `1-85`: **Overall assessment: The change is minimal and aligned with PR objectives.** The modification to the documentation source path is the only change in this file, and it correctly reflects the reorganization of documentation sections as described in the PR objectives. The rest of the workflow remains unchanged, which is good for maintaining consistency in the documentation generation process. To ensure the change is fully effective: 1. Verify that all necessary content has been migrated from the old "technical-documentation" folder to the new "architecture" folder. 2. Run the provided script to check for any remaining references to the old path in other parts of the documentation or code. 3. Consider updating the PR description or adding a comment to explain the rationale behind this specific change, which will help reviewers and future maintainers understand the context of the modification. --- `21-21`: **Approved: Update to documentation source path aligns with PR objectives.** The change from `"docs/technical-documentation/**/*.md"` to `"docs/architecture/**/*.md"` for the "whitepaper-tech-faq" bundle reflects the reorganization of documentation sections as outlined in the PR objectives. This update focuses on architecture-related documentation, which is in line with the new "API Reference" section mentioned in the PR summary. To ensure a smooth transition, please verify the following: 1. All relevant content from the old "technical-documentation" folder has been migrated to the new "architecture" folder. 2. No other parts of the documentation or code still reference the old path. Run the following script to check for any remaining references to the old path: This script will help identify any lingering references to the old path and confirm that the old directory has been properly removed or migrated.✅ Verification successful
**Verification Successful: No remaining references to the old documentation path.** The executed script confirmed that there are no lingering references to `technical-documentation` and that the `docs/technical-documentation` directory has been successfully removed. All changes align with the PR objectives and ensure a smooth documentation reorganization.🏁 Scripts executed
The following scripts were executed for the analysis: Script: ```shell #!/bin/bash # Description: Check for references to the old technical-documentation path # Search for references to the old path in all files echo "Searching for references to 'technical-documentation':" rg --type-add 'docs:*.{md,mdx}' --type docs --type yaml --type json 'technical-documentation' # Check if the old directory still exists if [ -d "docs/technical-documentation" ]; then echo "Warning: The 'docs/technical-documentation' directory still exists." echo "Contents:" ls -R docs/technical-documentation else echo "The 'docs/technical-documentation' directory has been removed." fi ``` Length of output: 401
I propose through this PR to restructure the different sections.
Details
The order of the existing sections has changed and a new section
API Reference
added containing generated documentations about smart contracts, cosmos custom modules, prolog predicates, ontology and CLI:Axone
Getting Started
Architecture
Connectors - WIP ⚙️
Guides
Running a Node
Whitepaper
Contribute to Axone
API Reference
FAQ
I also removed the old and unused versions of the generated documentations about smart contracts, cosmos custom modules, prolog predicates, ontology and CLI.
Some changes have been brought on the sidebar, there is now a single one to ease navigation between categories.
Misc
I took the opportunity to update some old links (e.g. explore, faucet...)
Summary by CodeRabbit