Skip to content

Conversation

@pcdubs
Copy link
Member

@pcdubs pcdubs commented Dec 8, 2025

Adds documentation for Fedora IoT bootable containers including building custom images, creating bootable devices with bootc-image-builder, deploying to existing systems, and best practices.

@miabbott
Copy link
Member

miabbott commented Dec 8, 2025

Thanks for starting these docs!

I understand that this content is useful to have in the IoT docs, but I worry that there is a lot of duplication from the upstream or Fedora bootc docs. This means having to keep docs up-to-date in more than one place.

I feel like a lot of the content after the "Deploying to Existing Devices" section gets into too much detail when you could just point folks to the upstream docs.

@pcdubs pcdubs force-pushed the add-bootable-containers branch 2 times, most recently from b4edc7d to 6126c84 Compare December 8, 2025 19:20
@pcdubs
Copy link
Member Author

pcdubs commented Dec 8, 2025

I understand that this content is useful to have in the IoT docs, but I worry that there is a lot of duplication from the upstream or Fedora bootc docs. This means having to keep docs up-to-date in more than one place.

I think there is value in showing iot specific examples and an overview.

I feel like a lot of the content after the "Deploying to Existing Devices" section gets into too much detail when you could just point folks to the upstream docs.

Thanks, I don't disagree and yanked out the best practices and troubleshooting sections. I think its a bit better now, wdyt?

Adds documentation for Fedora IoT bootable containers including
building custom images, creating bootable devices with
bootc-image-builder, deploying to existing systems.

Signed-off-by: Paul Whalen <pwhalen@fedoraproject.org>
@pcdubs pcdubs force-pushed the add-bootable-containers branch from 6126c84 to 52a04a0 Compare December 8, 2025 20:02
Copy link
Member

@miabbott miabbott left a comment

Choose a reason for hiding this comment

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

I still have some reservations about duplicating documentation from elsewhere, but I'll take the "disagree and commit" approach.

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.

2 participants