Skip to content

Conversation

@awhitcroft
Copy link

Initial documentation for the Snap lifecycles. This include the build lifecycle and the workflow lifecycle.

Copy link
Collaborator

@AnneCYH AnneCYH left a comment

Choose a reason for hiding this comment

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

Hi @awhitcroft , apologies for the delay.

I left some comments but they are mostly suggestions about the formatting; less concerns about the content.

Thanks!

```

```{toctree}
:maxdepth: 2
Copy link
Collaborator

Choose a reason for hiding this comment

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

Hi @awhitcroft , was there a reason for setting :maxdepth: 2 here?
For landing pages I would suggest keeping it clean and just having the title displayed.

@@ -0,0 +1,150 @@
**************
Snap Lifecycle
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Snap Lifecycle
Snap lifecycle

Ubuntu style guide recommends we use sentence case headings. Same comment for the rest of the doc.
https://docs.ubuntu.com/styleguide/en/#headings

Thanks.

Snap Lifecycle
**************

Snap Build Lifecycle
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Snap Build Lifecycle
Snap build lifecycle

**************
Snap Lifecycle
**************

Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
This guide describes the build and workflow lifecycle of kernel snaps.

Ubuntu style guide also advises against stacked headings, e.g. headings need to be followed by content.
https://docs.ubuntu.com/styleguide/en/#headings

Background
----------
The majority of kernels with snaps are consumed both as Debian packages and
those snaps. To reduce testing requirements and streamline production the same
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
those snaps. To reduce testing requirements and streamline production the same
snaps. To reduce testing requirements and streamline production, the same

Comment on lines +131 to +132
Testing
-------
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Testing
-------
Testing
-------

Comment on lines +137 to +138
QA Testing
----------
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
QA Testing
----------
QA testing
----------


QA Testing
----------
Once we have a formal canidate snap this may be sent for further acceptance
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Once we have a formal canidate snap this may be sent for further acceptance
Once we have a formal candidate snap this may be sent for further acceptance

Comment on lines +144 to +145
Release
-------
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Release
-------
Release
-------

Comment on lines +148 to +149
with the promotion of the Debian package to ``updates``. The Debian package my
then promote further to ``security`` but there is no equivalent channel for
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
with the promotion of the Debian package to ``updates``. The Debian package my
then promote further to ``security`` but there is no equivalent channel for
with the promotion of the Debian package to ``updates``. The Debian package
may then promote further to ``security`` but there is no equivalent channel for

Copy link
Collaborator

@AnneCYH AnneCYH left a comment

Choose a reason for hiding this comment

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

Hi @awhitcroft , apologies for the delay.

I left some comments but they are mostly suggestions about the formatting; less concerns about the content.

Thanks!

@AnneCYH
Copy link
Collaborator

AnneCYH commented Oct 17, 2025

There are also a few words that need to be added to .custom_wordlist.txt

bootable
initramfs
parameterizes
signoff
UKI
UKIs

Thanks!

parameterises the snapcraft.yaml configuration, and kicks off builds against
the appropriate snap build recipe. This causes the kernel to be processed into
a snap and uploaded to the snap-store. The store will automatically publish this
onto the ``edge`` channel for testing.
Copy link
Collaborator

Choose a reason for hiding this comment

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

If there are test failures for the snap in "edge", does that gate the progress of the Debian package to "proposed"?

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