Specification docs or just The Code? : MachineConfig

[trharmon0]

Hello. I'm new to the project but deep-diving over the holiday season.

I see that MachineConfig and some of the other YAML document types are versioned. Does that imply the existence of specification documents? Or just reference the code? In either case, how to track coming updates to the specifications?

thx

[smira]

Talos machine configuration is fully documented: https://docs.siderolabs.com/talos/v1.12/reference/configuration/overview

Machine configuration is always backwards compatible, but the list of changes is communicated in release notes: https://docs.siderolabs.com/talos/v1.12/configure-your-talos-cluster/lifecycle-management/upgrading-talos#machine-configuration-changes

[trharmon0]

Ty. That's helpful.

So if I'm hoping to track upcoming changes it looks like it's a matter of following PRs? The branches shown in the repo are just per-release and so I'm assuming development largely happens in private repos and is then squashed to a release branch before being pushed to the public repos?

[smira]

Development of Talos Linux happens in completely open manner, just follow main branch. Release branches are snapshots of main used to handle stable releases.

[trharmon0]

Development of Talos Linux happens in completely open manner, just follow main branch. Release branches are snapshots of main used to handle stable releases.

Super. Thx. /me runs off to look for LSP etc..