Skip to content

docs: publish the complete fillable knowledge framework - #11

Merged
BotshareAI merged 1 commit into
mainfrom
feat/knowledge-hub-architecture
Aug 31, 2026
Merged

docs: publish the complete fillable knowledge framework#11
BotshareAI merged 1 commit into
mainfrom
feat/knowledge-hub-architecture

Conversation

@BotshareAI

Copy link
Copy Markdown
Contributor

Summary

Completes the Knowledge Hub architecture merged in #10 by publishing the full documentation skeleton as visible, navigable pages.

  • Adds 354 under-development framework pages across Foundations, Build, Use, Configure, Customize, Maintain & Repair, repository reference, learning tracks, Academy, Community, and About
  • Expands the site to 408 Markdown pages in total
  • Exposes every normal documentation page in a 470-line hierarchical MkDocs navigation; only the special 404.md remains outside navigation
  • Gives each unfinished page a consistent purpose, status, audience/outcome template, prerequisites, safety, verification, troubleshooting, and contribution structure
  • Adds the corresponding OpenAMRobot repository to relevant technical pages
  • Adds authoritative ROS 2 Jazzy, Nav2, MoveIt 2, Gazebo, micro-ROS, ros2_control, URDF, tf2, REP-105, and ROS security references where relevant
  • Enables navigation instant loading, tracking, pruning, toc.follow, and linked tabs to keep the 400-page site usable

Content policy

Framework pages are clearly marked Under development and explicitly warn readers not to treat unfinished material as validated build or deployment instructions. Exact versions, parameters, and contracts remain canonical in owning repositories.

Validation

  • python -m mkdocs build --strict passes with social temporarily disabled locally; the production configuration keeps it enabled
  • All normal documentation pages are included in navigation; only 404.md is intentionally excluded
  • git diff --check passes

Follow-up to #10.

Signed-off-by: OpenAI Codex <info@botshare.ai>
@BotshareAI
BotshareAI merged commit 907297a into main Aug 31, 2026
3 of 4 checks passed
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.

1 participant