Skip to content

Create user documentation - #150

Open
alicefr wants to merge 6 commits into
bootc-dev:mainfrom
alicefr:user-docs
Open

Create user documentation #150
alicefr wants to merge 6 commits into
bootc-dev:mainfrom
alicefr:user-docs

Conversation

@alicefr

@alicefr alicefr commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Generate the user documentation following the same model as bootc using mdBook. The first chapter describes the basic operation such as creation a pool, triggering a rollout and pausing the pool.

Fixes: #78

Comment thread .github/workflows/docs.yml Fixed
Comment thread .github/workflows/docs.yml Fixed
Make room for mdBook user documentation by moving developer design
artifacts to a dedicated subdirectory.

Signed-off-by: Alice Frosi <afrosi@redhat.com>
Set up the mdBook scaffolding with a placeholder introduction page.
Add Makefile targets for building and serving docs locally.

Assisted-by: AI
Signed-off-by: Alice Frosi <afrosi@redhat.com>
Build mdBook and deploy to GitHub Pages on push to main when docs/
changes. This is similarly to what bootc is doing in the main repo.

Assisted-by: AI
Signed-off-by: Alice Frosi <afrosi@redhat.com>
Signed-off-by: Alice Frosi <afrosi@redhat.com>
Add the introduction for the bootc operator, a summary and introduce the
first concepts of the bootc node pool and bootc node.

Assisted-by: AI
Signed-off-by: Alice Frosi <afrosi@redhat.com>
Include how to create a pool, how to pause and it covers rollback.

Signed-off-by: Alice Frosi <afrosi@redhat.com>
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.

Add end-user documentation

2 participants