831343 – Reasons for profile version numbering should be documented

Bug 831343 - Reasons for profile version numbering should be documented

Summary: Reasons for profile version numbering should be documented

Status:	UNCONFIRMED

Alias:	None

Product:	Documentation
Classification:	Unclassified
Component:	Devmanual (show other bugs)
Hardware:	All Linux

Importance:	Normal normal (vote)
Assignee:	Gentoo Devmanual Team

URL:
Whiteboard:
Keywords:	NeedPatch

Depends on:
Blocks:

Reported:	2022-01-17 08:54 UTC by Einstok Fair
Modified:	2022-06-04 10:07 UTC (History)
CC List:	2 users (show)

See Also:
Package list:
Runtime testing required:	---

Attachments
notes from #gentoo channel (profile_notes.txt,6.81 KB, text/plain) 2022-01-17 08:54 UTC, Einstok Fair	Details
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.

Description Einstok Fair 2022-01-17 08:54:04 UTC

Created attachment 762388 [details]
notes from #gentoo channel

Profile names contain a version number, such as 17.0 or 17.1.
It would be nice to have list of reasons when one need to increase the version.

Such as:
- changes in File Hierarchy Standard (FHS)
- splitting system packages into parts
- something else?

It is also nice to explain why rules are added and what wrong will happen if they will not be followed. The last thought is applicable to all other rules in developers guide. Right now there are no such explanations in many places.

Also it will be nice to have the documentation for specific use case of profile usage - for synchronization of settings between binary server and it's clients. It's common enough, i think.