Skip to content

Docs/add principles doc - #2308

Open
iqraurooj111 wants to merge 2 commits into
flatcar:mainfrom
iqraurooj111:docs/add-principles-doc
Open

Docs/add principles doc#2308
iqraurooj111 wants to merge 2 commits into
flatcar:mainfrom
iqraurooj111:docs/add-principles-doc

Conversation

@iqraurooj111

@iqraurooj111 iqraurooj111 commented Aug 9, 2026

Copy link
Copy Markdown

Title: describe the change in one sentence

describe the change in 1 - 3 paragraphs

How to use

describe what reviewers need to do in order to validate this PR

Testing done

[Describe the testing you have done before submitting this PR. Please include both the commands you issued as well as the output you got.]

  • Changelog entries added in the respective changelog/ directory (user-facing change, bug fix, security fix, update)
  • Inspected CI output for image differences: /boot and /usr size, packages, list files for any missing binaries, kernel modules, config files, kernel modules, etc.

 Adds a new PRINCIPLES.md document that explains Flatcar's core
design philosophy (no package manager, immutable filesystem,
declarative provisioning via Ignition, atomic updates) and how
Flatcar differs from Talos Linux.

Addresses the question raised in flatcar#1728 about whether Flatcar
has a principles document.

Signed-off-by: Iqra Urooj <iqraurooj111@gmail.com>
Signed-off-by: Iqra Urooj <iqraurooj111@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Development

Successfully merging this pull request may close these issues.

1 participant