Skip to content

Moving docs over#1

Open
nimbinatus wants to merge 35 commits into
bootc-dev:mainfrom
nimbinatus:initial-push
Open

Moving docs over#1
nimbinatus wants to merge 35 commits into
bootc-dev:mainfrom
nimbinatus:initial-push

Conversation

@nimbinatus

@nimbinatus nimbinatus commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Moving over docs from bootc-dev/bootc. Commands run (for history's sake):

git format-patch --root HEAD -o ../patches -- ./ADOPTERS.md ./CODE_OF_CONDUCT.md ./CONTRIBUTING.md ./GOVERNANCE.md ./MAINTAINERS.md ./REVIEW.md ./SECURITY.md
git am --committer-date-is-author-date ../patches/*.patch

Also had to do a bunch of signing for stuff that wasn't signed. Preserved as much as possible, though.

jbtrystram and others added 7 commits July 4, 2023 15:36
…f the image to see if any update and available. It could be named `--dry-run` but I wanted to be consistent with `rpm-ostree` Fixes #3

Signed-off-by: jbtrystram <jbtrystram@redhat.com>
In a fresh Fedora 39 container, I had to install the updated list of
dependencies to successfully run:

- cargo fmt
- cargo clippy
- cargo build --release

Signed-off-by: Micah Abbott <miabbott@redhat.com>
`CONTRIBUTING.md` is a friendlier and more common name.
Explain the DCO bits in particular.

Closes: bootc-dev/bootc#574

Signed-off-by: Colin Walters <walters@verbum.org>
The `make validate-rust` reproduces locally the same checks
we run in CI as gating by default; hook it up to the existing
`make validate`.

Signed-off-by: Colin Walters <walters@verbum.org>
Signed-off-by: Colin Walters <walters@verbum.org>
These files help clarify/formalize some information.
In particular I'd like to look at tools that auto-sync from MAINTAINERS
to the github permissions so that we can maintain that in a git-ops
fashion.

Signed-off-by: Colin Walters <walters@verbum.org>
Copyedit the universal blue entry.

Signed-off-by: Jorge O. Castro <jorge.castro@gmail.com>
@nimbinatus nimbinatus force-pushed the initial-push branch 2 times, most recently from 7b68205 to cd0979e Compare June 16, 2026 21:03
nothingneko and others added 21 commits June 16, 2026 16:04
Signed-off-by: Colin Walters <walters@verbum.org>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
He'll be at least helping maintain CI and approving issues related
to that.

Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
This is implementing https://github.com/cncf/project-template/blob/main/GOVERNANCE-maintainer.md

Co-authored-by: Colin Walters <walters@verbum.org>
Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
Signed-off-by: Colin Walters <walters@verbum.org>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
Signed-off-by: John Eckersberg <jeckersb@redhat.com>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
to the ADOPTERS.md. We have builds dating all the way back to 2022.

Signed-off-by: Luke Short <ekultails@gmail.com>
Feel free to adjust wording as needed, this is just an example.

This is a good way to empower PMs other folks to be able to help out with meta things around the project. We explicitly list the the role in governance so that the people listed here end up in the main cncf maintainers.csv.

Being in the csv file is important because it is a check the CNCF uses to ensure maintainers are requesting the resources. And for CFP submissions, "did one of the maintainers submit this talk or was it someone else?", etc.

Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
The emphasis here is on trying to have
the `Justfile` be the default entrypoint,
wrapping other tools.

- Replace mentions of podman-bootc with bcvk
  since I hope the latter supercedes the former
- Unify the unit test entrypoint
- Set up /var/tmp as a tmpdir to fix the etc merge
  test (otherwise, selinux failures w/tmp)
- Run the unit+container tests in integration.yml
- Have `just validate` run in a container

Signed-off-by: Colin Walters <walters@verbum.org>
Added myself as the maintainer, needed for contributing videos to CNCF channel.

Signed-off-by: mohan-shash <162627980+mohan-shash@users.noreply.github.com>
Fix a few typos across the project. Also update some comments/error
messages

Signed-off-by: Pragyan Poudyal <pragyanpoudyal41999@gmail.com>
Synchronized from bootc-dev/infra@d5a5a62.

Signed-off-by: bootc-dev Bot <bot@bootc.dev>
Co-authored-by: bootc-dev Bot <bot@bootc.dev>
The previous commit consolidated test content (nushell, cloud-init, etc.)
into the base image. This completes that work by removing the separate
`build-integration-test-image` target and updating all references.

Now `just build` produces the complete test-ready image directly,
simplifying the build pipeline and eliminating the intermediate
`localhost/bootc-integration` image.

Also adds SKIP_CONFIGS support for the coreos testing workflow, which
skips LBIs, test kargs, and install configs that would conflict with FCOS.

Signed-off-by: Colin Walters <walters@verbum.org>
Justfile changes:
- Organize targets into groups (core, testing, docs, debugging, maintenance)
- Add `list-variants` target to show available build variants
- Simplify comments to be concise single-line descriptions
- Move composefs targets (build-sealed, test-composefs) into core group

CONTRIBUTING.md changes:
- Reference `just --list` and `just list-variants` instead of duplicating
- Remove tables that duplicate Justfile information
- Fix broken link to cli.rs

The Justfile is now self-documenting via `just --list` (grouped targets)
and `just list-variants` (build configuration options).

Assisted-by: OpenCode (Claude Sonnet 4)
Signed-off-by: Colin Walters <walters@verbum.org>
Added AlmaLinux (Atomic SIG) as a new adopter

Signed-off-by: Alex Iribarren <alex@almalinux.org>
Preethi represents bootc in public forums like Kubecon,
RH Summit and our community meetings.

Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>
Signed-off-by: Michael L. Young <myoung@ciq.com>
Signed-off-by: Ziad Khouri <ziad@caligra.com>
Signed-off-by: Laura Santamaria <nimbinatus@users.noreply.github.com>
KyleGospo and others added 7 commits June 16, 2026 16:04
Signed-off-by: Kyle Gospodnetich <me@kylegospodneti.ch>
Updated the description for Universal Blue to clarify its features.

Signed-off-by: Kyle Gospodnetich <me@kylegospodneti.ch>
For most work on `bootc upgrade` or `bootc switch`, rebuilding the
full container image is unnecessary. This adds a fast-path workflow
that builds just the bootc binary into a systemd-sysext and overlays
it onto /usr in a persistent bcvk VM via virtiofs.

For more info see the updated Justfile.

There's still some TODOs here - e.g. we need to support running
the TMT tests this way, etc.

Assisted-by: OpenCode (claude-opus-4-6)
Signed-off-by: Colin Walters <walters@verbum.org>
Synchronized from bootc-dev/infra@fb9e91b.

Signed-off-by: bootc-dev Bot <bot@bootc.dev>
The composefs backend has a multi-dimensional configuration space
(variant, bootloader, boot_type, seal_state, filesystem) with
non-obvious constraints between them. Add a clear reference table
and common workflow examples to CONTRIBUTING.md, and a quick-start
cheat sheet to the Justfile header.

Assisted-by: OpenCode (Claude Opus 4)
Signed-off-by: Colin Walters <walters@verbum.org>
Synchronized from bootc-dev/infra@ff66c1c.

Signed-off-by: bootc-dev Bot <bot@bootc.dev>
Signed-off-by: Joseph Marrero Corchado <jmarrero@redhat.com>

@cgwalters cgwalters left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for starting this!

Comment thread CONTRIBUTING.md
@@ -0,0 +1,338 @@
# Contributing to bootc

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should generalize this now that there's more projects in the bootc-dev ecosystem; besides bcvk we added the operator etc., plus infra stuff and actions.

Comment thread MAINTAINERS.md
@@ -0,0 +1,23 @@
# Maintainers

The current Maintainers Group for the bootc Project consists of:

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We definitely are going to need to figure out how to auto-sync this metadata, we already have other maintainers for the other recently added projects.

Comment thread SECURITY.md
@@ -0,0 +1,19 @@
# Security Policy

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this file can should actually move into infra/common.

In fact, I wonder if most of the files here should actually just be auto-synchronized from infra/common to each repo (apart from MAINTAINERS.md)?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Basically just drop files in https://github.com/bootc-dev/infra/tree/main/common and they get auto-synced to all repos in this org and the composefs org.

Comment thread CODE_OF_CONDUCT.md
@@ -0,0 +1,4 @@
# Bootc Project Code of Conduct

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should be in infra/common

@cgwalters

Copy link
Copy Markdown

Moving over docs from bootc-dev/bootc. Commands run (for history's sake):

I'm fine with this, it's nice to preserve history, but glancing at this offhand I think most of the history is about MAINTAINERS.md - if we keep that one in bootc and go with per-project MAINTAINERS.md (some tradeoffs there I know) then I think for the other ones to move to infra/common/ we probably don't need to care about history.

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.