Skip to content

docs(plugins): explain module contracts and verify plugin examples - #69

Merged
nick2781 merged 5 commits into
mainfrom
docs/plugin-guides
Oct 16, 2026
Merged

nick2781 merged 5 commits into
mainfrom
docs/plugin-guides

Conversation

@nick2781

@nick2781 nick2781 commented Oct 16, 2026 •

Copy link
Copy Markdown
Member

Explain the responsibilities of modules and plugins, service lookup, configuration and lifecycle ownership in four bilingual guides. Provide a complete external plugin example covering its public headers, CMake target, exported entries, application manifest and actual load/update/unload flow.

The branch incorporates accepted main 6b773269b6c761d18e87bd96665780d24e2447ca. Only the original four guide documents differ; their text and twelve bilingual code blocks are unchanged from the reviewed implementation. The newly accepted source layout and architecture archive are preserved.

Validation at 2e3db816cb9af6ea40ff198ccb96bf371d02b201, tree 2244a4c94c27516215f3d815249eced239d72ca5:

  • Fresh Release and Debug external plugin/driver builds against the new layout passed actual initialization, five updates, orderly stop and unload; exported entry pairs and compiled inputs match the documented examples. Runtime/SDK build inputs remain unchanged after incorporating the documentation-only main update.
  • Current-source 34 CI/README tests and the complete seven-test Nimbus/site checks passed: no Astro diagnostics, 115 HTML pages and 195 internal references verified.
  • Format, local example-link checks, source conservation and whitespace checks passed. The final worktree is clean.

Windows/Linux execution of this particular external example was not performed locally. The guides describe current lifecycle limits and do not introduce hot replacement, a general callback-drain guarantee or a shutdown-policy change. Published-head checks and the actual protected merge-queue candidate remain required before squash acceptance.

@nick2781
nick2781 added this pull request to the merge queue Oct 16, 2026
@nick2781
nick2781 removed this pull request from the merge queue due to a manual request Oct 16, 2026
@nick2781
nick2781 added this pull request to the merge queue Oct 16, 2026
Merged via the queue into main with commit 6556aaf Oct 16, 2026
7 checks passed
@nick2781
nick2781 deleted the docs/plugin-guides branch October 16, 2026 13:35
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