Skip to content

docs: split slice design approaches into content, function and tier - #90

Merged
asanvaq merged 17 commits into
mainfrom
feat/slice-design-approaches-update
Oct 16, 2026
Merged

asanvaq merged 17 commits into
mainfrom
feat/slice-design-approaches-update

Conversation

@lczyk

@lczyk lczyk commented Sep 24, 2026

Copy link
Copy Markdown
Contributor

this splits "grouping by function" into two approaches: function (feature slices like libpython3.12-stdlib_crypto, systemd_dbus-services) and tier (minimal / core / standard
/ dev).

  • tier section now spells out the superset rule (higher tier lists the lower one in essential), says not all four tiers are required, and recommends core + function slices as the default for most apps
  • intro notes the approaches can be mixed in one sdf (e.g. systemd)
  • slice-a-package how-to updated to say three approaches

@lczyk

lczyk commented Sep 24, 2026

Copy link
Copy Markdown
Contributor Author

@upils

@lczyk
lczyk marked this pull request as ready for review September 24, 2026 14:42
explain when to use standard (regular installation behaviour) vs core with function slices (to minimise root filesystem footprint).
@lczyk
lczyk requested a review from upils September 24, 2026 15:01

@upils upils left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks @lczyk!

It looks great despite the couple of comments.

Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md
Comment thread docs/explanation/slice-design-approaches.md Outdated
@upils
upils requested a review from asanvaq September 25, 2026 07:03
@lczyk
lczyk requested a review from alesancor1 September 25, 2026 08:41

@asanvaq asanvaq left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Hi! Thank you so much! This has greatly improved this page. I added a few comments, I look forward to hearing your thoughts!

Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
lczyk and others added 2 commits September 27, 2026 20:42
Co-authored-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Marcin Konowalczyk <marcin.konowalczyk@canonical.com>
@lczyk
lczyk requested review from asanvaq and upils September 27, 2026 19:53

@upils upils left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks @lczyk. It is almost good to know I think.

Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
@lczyk
lczyk requested a review from upils October 13, 2026 12:05

@asanvaq asanvaq left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Last suggestions before I can approve it. The first one is a nit, the second one fixes the syntax of the note.

Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
lczyk and others added 2 commits October 14, 2026 10:32
Co-authored-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Marcin Konowalczyk <marcin.konowalczyk@canonical.com>
Co-authored-by: Anna Sancho Vaquer <anna.sanchovaquer@canonical.com>
Signed-off-by: Marcin Konowalczyk <marcin.konowalczyk@canonical.com>
@lczyk
lczyk requested a review from asanvaq October 14, 2026 09:33

@asanvaq asanvaq left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thank you so much!

@upils upils left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Thanks!

@alesancor1 alesancor1 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM overall, just a couple of things - not really enough to block the merge so just commenting

Comment thread docs/explanation/slice-design-approaches.md Outdated
Comment thread docs/explanation/slice-design-approaches.md Outdated
lczyk and others added 2 commits October 16, 2026 09:45
Clarify the relationship between slice tiers and their dependencies.

Signed-off-by: Marcin Konowalczyk <marcin.konowalczyk@canonical.com>

@alesancor1 alesancor1 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM, thanks for the changes!

@asanvaq

asanvaq commented Oct 16, 2026

Copy link
Copy Markdown
Contributor

Fixes #63

@asanvaq
asanvaq merged commit dce9a82 into main Oct 16, 2026
5 checks passed
@asanvaq
asanvaq deleted the feat/slice-design-approaches-update branch October 16, 2026 10:54
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.

4 participants