mirror of
https://gitee.com/pnoker/iot-dc3.git
synced 2026-11-03 03:32:08 +08:00
pnoker
3f405eb604
Contributing now describes the actual trunk-based flow where feature branches target main, and the usage guide plus the six preview driver readmes publish honest status tables for connection, read, write and health coverage.
IoT DC3 Documentation
Most documentation has migrated to the project documentation site. This directory keeps only the source files the release process depends on.
Online documentation
- Documentation site: https://docs.dc3.site/
- Documentation source repository: pnoker/iot-dc3-docs
Files retained in this directory (referenced directly by CI - do not migrate)
| File | Purpose |
|---|---|
TITLE.md |
Release title and summary, assembled into the GitHub Release body by .github/workflows/docker-ci.yml |
CHANGE.md |
Version changelog, written by dc3/bin/changelog.py and assembled into the Release body by docker-ci |
RELEASE-FOOTER.md |
Release quick-start footer (docs links and image pinning), assembled into the Release body by docker-ci |
USAGE.md |
Image usage guide; embedded into the docs site usage page and referenced from the release footer |
DEPLOYMENT.md |
Full deployment runbook (compose scale / swarm / k8s / helm); linked from USAGE.md and snapshotted into the docs site by scripts/sync-external.sh in the docs repository |
The documentation site embeds the changelog
and images & deployment pages from the files above through VitePress
<!--@include:--> syntax, keeping a single source of truth.
Old paths migrated to the documentation site
| Old path | New location |
|---|---|
dc3/doc/QUICKSTART.md |
Quick Start |
dc3/doc/ENVIRONMENT.md |
Environment Variables |
dc3/doc/LOGGING.md |
Logging Conventions |
dc3/doc/TROUBLESHOOTING.md |
Troubleshooting |
dc3/doc/MODULES.md |
Modules & Dependencies |
dc3/doc/DRIVER-AUTHORING.md |
Driver Authoring |
dc3/doc/TESTING.md |
Testing |
If an external link brought you here, please update your bookmark to the new address.