Skip to content

Align module documentation with inline module implementations#240

Open
SemTiOne wants to merge 4 commits into
RonaldHensbergen:mainfrom
SemTiOne:docs/align-modules-md-with-implementation
Open

Align module documentation with inline module implementations#240
SemTiOne wants to merge 4 commits into
RonaldHensbergen:mainfrom
SemTiOne:docs/align-modules-md-with-implementation

Conversation

@SemTiOne

Copy link
Copy Markdown
Collaborator

Pull Request

Summary

module.yaml is the only required file. Compose lives inline at spec.implementation.compose, config validated via spec.configSchema. README.md optional, unread by validator.

Also fixed a wrong custom-image example, added provides/consumes to Dependency rules.

Closes #231, supersedes #141.

Type Of Change

  • Bug fix
  • Feature
  • Refactor
  • Docs
  • Test only

User Impact

Module authoring docs now match module.yaml/schemas/module.schema.json, no more false required-file claims.

Validation

Docs-only change. All tests passed.

python -m unittest discover -s tests -p "*.py"

Checklist

  • Tests added or updated
  • Docs updated (README or docs)
  • No secrets committed
  • Generated artifacts excluded from git

@SemTiOne SemTiOne changed the title docs/modules.md: match module.yaml, not compose.yml/.env.example Align module documentation with inline module implementations Jul 26, 2026
@RonaldHensbergen

Copy link
Copy Markdown
Owner

I would like to have #235 completed before reviewing this

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.

Align module documentation with inline module implementations

2 participants