Features/Dotted Activity Versions - Revision history

Godiard at 18:59, 5 November 2013

2013-11-05T18:59:58Z

← Older revision		Revision as of 14:59, 5 November 2013
Line 1:		Line 1:
	<noinclude>		<noinclude>
	[[Category:~~Feature Page Incomplete]]~~		[[Category:FeatureLanded\|Dotted Activity Versions]]
	~~[[Category:Feature~~\|Dotted Activity Versions]]
	</noinclude>		</noinclude>

Godiard at 20:23, 11 November 2010

2010-11-11T20:23:16Z

← Older revision		Revision as of 16:23, 11 November 2010
Line 43:		Line 43:

	== Benefit to Sugar ==		== Benefit to Sugar ==
	The new scheme gives activity developers more control on their releases. The separation between a major release and a minor (bugfix) release is more clearly visible. Since developers can still use just integer numbers the simplicity of the old scheme is kept.		The new scheme gives activity developers more control on their releases. The separation between a major release and a minor (bugfix) release is more clearly visible. Since developers can still use just integer numbers the simplicity of the old scheme is kept.

			This scheme also enables developers who maintain older versions of Sugar, building activities with intermediate versions, in cases where it is not possible to use the latest changes because are not compatible.

	== Scope ==		== Scope ==

FGrose at 18:22, 5 November 2010

2010-11-05T18:22:15Z

← Older revision		Revision as of 14:22, 5 November 2010
Line 2:		Line 2:
	[[Category:Feature Page Incomplete]]		[[Category:Feature Page Incomplete]]
	[[Category:Feature\|Dotted Activity Versions]]		[[Category:Feature\|Dotted Activity Versions]]
			</noinclude>

	== Summary ==		== Summary ==
Line 17:		Line 18:

	== Detailed Description ==		== Detailed Description ==
	The new numbering scheme is more flexible and allows you to do major and minor releases. This is useful when you want to do for example a bug fix release. The new version number will consist of N integers separated by dots (e.g. 1, 1.2, 1.4.5, 2.5.7.4). You can still use an integer number only for your releases.		The new numbering scheme is more flexible and allows you to do major and minor releases. This is useful when you want to do for example a bug fix release. The new version number will consist of N integers separated by dots (e.g., 1, 1.2, 1.4.5, 2.5.7.4). You can still use an integer number only for your releases.

	There is as well the ability to use a suffix for a local indicator (e.g. Peru wants to release a slightly modified version for their deployment 1.3-peru). The local indicator is a string, appended to the version. The local indicator does not apply alpha ordering, which means that 1.3-peru is equal to 1.3-argentina.		There is as well the ability to use a suffix for a local indicator (e.g., Peru wants to release a slightly modified version for their deployment 1.3-peru). The local indicator is a string, appended to the version. The local indicator does not apply alpha ordering, which means that 1.3-peru is equal to 1.3-argentina.

	Valid:		Valid:
Line 29:		Line 30:

	Not valid:		Not valid:
	1.2peru # must be separated with a '-'		1.2peru # must be separated with a '-'
	1.2. # can't end with '.'		1.2. # can't end with '.'
	1.02.5 # can't have a leading zero		1.02.5 # can't have a leading zero

	Comparisons:		Comparisons:
Line 68:		Line 69:

	== Documentation ==		== Documentation ==
	[~~http://wiki.sugarlabs.org/go/~~Development_Team/Almanac/Activity_Bundles#.info_file_format The activity.info file documentation] will be adjusted accordingly once this feature lands. The discussion about this feature has been taking place at this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html thread] on the sugar-devel mailing list.		[[Development_Team/Almanac/Activity_Bundles#.info_file_format \|The activity.info file documentation]] will be adjusted accordingly once this feature lands. The discussion about this feature has been taking place at this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html thread] on the sugar-devel mailing list.

	== Release Notes ==		== Release Notes ==

Erikos: /* Benefit to Sugar */

2010-11-05T09:55:01Z

Benefit to Sugar

← Older revision		Revision as of 05:55, 5 November 2010
Line 42:		Line 42:

	== Benefit to Sugar ==		== Benefit to Sugar ==
			The new scheme gives activity developers more control on their releases. The separation between a major release and a minor (bugfix) release is more clearly visible. Since developers can still use just integer numbers the simplicity of the old scheme is kept.


	== Scope ==		== Scope ==

Erikos: /* Scope */

2010-11-05T09:51:12Z

Scope

← Older revision		Revision as of 05:51, 5 November 2010
Line 46:		Line 46:

	== Scope ==		== Scope ==
	This feature does add a new class to the toolkit that is used to verify the correctness of the numbering string. The bundlebuilder and the activitybundle are adjusted accordingly (~~current~~ [http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch toolkit patch]). In the shell the activity list and the bundleregistry has to change accordingly ([http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch current shell patch]).		This feature does add a new class to the toolkit that is used to verify the correctness of the numbering string. The bundlebuilder and the activitybundle are adjusted accordingly ([http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch current toolkit patch]). In the shell the activity list and the bundleregistry has to change accordingly ([http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch current shell patch]).

	Furthermore the activity updater has to adopt to the new scheme.		Furthermore the activity updater has to adopt to the new scheme.

Erikos: /* Scope */

2010-11-05T09:50:48Z

Scope

← Older revision		Revision as of 05:50, 5 November 2010
Line 46:		Line 46:

	== Scope ==		== Scope ==
			This feature does add a new class to the toolkit that is used to verify the correctness of the numbering string. The bundlebuilder and the activitybundle are adjusted accordingly (current [http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch toolkit patch]). In the shell the activity list and the bundleregistry has to change accordingly ([http://bugs.sugarlabs.org/attachment/ticket/2425/0001-Adopt-to-new-numbering-scheme-2425.patch current shell patch]).

			Furthermore the activity updater has to adopt to the new scheme.

	==UI Design==		==UI Design==

Erikos: /* Documentation */

2010-11-05T09:46:41Z

Documentation

← Older revision		Revision as of 05:46, 5 November 2010
Line 68:		Line 68:

	== Documentation ==		== Documentation ==
	[http://wiki.sugarlabs.org/go/Development_Team/Almanac/Activity_Bundles#.info_file_format The activity.info file documentation] will be adjusted accordingly once this feature ~~has landed~~. The discussion about this feature has been taking place at this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html thread] on the sugar-devel mailing list.		[http://wiki.sugarlabs.org/go/Development_Team/Almanac/Activity_Bundles#.info_file_format The activity.info file documentation] will be adjusted accordingly once this feature lands. The discussion about this feature has been taking place at this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html thread] on the sugar-devel mailing list.

	== Release Notes ==		== Release Notes ==

Erikos: /* Detailed Description */

2010-11-05T09:45:38Z

Detailed Description

← Older revision		Revision as of 05:45, 5 November 2010
Line 22:		Line 22:

	Valid:		Valid:
	1		1
	1.2		1.2
	1.2.3		1.2.3
	2.4.6.7		2.4.6.7
	2.3-peru		2.3-peru

	Not valid:		Not valid:
	1.2peru # must be separated with -		1.2peru # must be separated with a '-'
	1.2. # can't end with '.'		1.2. # can't end with '.'
	1.02.5 # can't have a leading zero		1.02.5 # can't have a leading zero

	Comparisons:		Comparisons:
	12 == 12		12 == 12
	0.9.9 < 1		0.9.9 < 1
	1 == 1.0.0		1 == 1.0.0
	1.2 < 1.2.3		1.2 < 1.2.3
	1.2-arg == 1.2		1.2-arg == 1.2
	1.2-arg == 1.2-peru		1.2-arg == 1.2-peru

	== Benefit to Sugar ==		== Benefit to Sugar ==

Erikos: Update the status

2010-11-05T09:41:14Z

Update the status

← Older revision		Revision as of 05:41, 5 November 2010
Line 1:		Line 1:
	<noinclude>~~{{Dated\|See this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html discussion thread] for more up-to-date information.}}~~		<noinclude>
	[[Category:Feature ~~Accepted 0.88~~]]		[[Category:Feature Page Incomplete]]
	[[Category:Feature\|Dotted Activity Versions]]		[[Category:Feature\|Dotted Activity Versions]]

	== Summary ==		== Summary ==
	~~This Feature adds a minor part to~~ the activity version~~. It will reuse the existing activity version field as the~~ major ~~part (integer). A new field will be introduced that will be the~~ minor ~~part (fraction) of the new floating point activity version~~.		Extend the activity version numbering scheme to allow major and minor releases.

	== Owner ==		== Owner ==
Line 12:		Line 12:

	== Current status ==		== Current status ==
	* Targeted release: 0.88		* Targeted release: 0.92
	* Last updated: ~~Tue~~, ~~09. Feb~~ 2010		* Last updated: Fri, 05 Nov 2010
	* Percentage of completion: 80%		* Percentage of completion: 90%

	== Detailed Description ==		== Detailed Description ==
	A new ~~field~~ is ~~added~~ to ~~the activity~~.~~info file~~ (~~activity_minor_version~~). ~~Internally~~ the ~~activity~~ version ~~will become represented as~~ a ~~float~~, ~~constructing~~ the ~~value of the minor and major part if the minor part is available~~. ~~Otherwise the activity version~~ is ~~converted~~ to a ~~float~~.		The new numbering scheme is more flexible and allows you to do major and minor releases. This is useful when you want to do for example a bug fix release. The new version number will consist of N integers separated by dots (e.g. 1, 1.2, 1.4.5, 2.5.7.4). You can still use an integer number only for your releases.

			There is as well the ability to use a suffix for a local indicator (e.g. Peru wants to release a slightly modified version for their deployment 1.3-peru). The local indicator is a string, appended to the version. The local indicator does not apply alpha ordering, which means that 1.3-peru is equal to 1.3-argentina.

			Valid:
			1
			1.2
			1.2.3
			2.4.6.7
			2.3-peru

			Not valid:
			1.2peru # must be separated with -
			1.2. # can't end with '.'
			1.02.5 # can't have a leading zero

			Comparisons:
			12 == 12
			0.9.9 < 1
			1 == 1.0.0
			1.2 < 1.2.3
			1.2-arg == 1.2
			1.2-arg == 1.2-peru

	== Benefit to Sugar ==		== Benefit to Sugar ==

	Let activity developers release bugfix versions and do not mess them with already released new versions(e.g. bugfix for several-versions-ago release w/o breaking/confusing-users existed versioning scheme).

	== Scope ==		== Scope ==

	~~This feature enhance the versioning scheme of activities. An optional field is added to the activity config file activity.info.~~

	==UI Design==		==UI Design==

	The activity version is only visible in the activity list.		The new activity version is only visible in the activity list and the activity updater.

	== How To Test ==		== How To Test ==
	* add the minor part to an activity.info file of an activity
	* you should be able to change the favorite status in the activities list of new and old style activities
	* you should be able to install activities (check newer and older versions of the same activity, too)

	== User Experience ==		== User Experience ==
Line 45:		Line 65:
	== Contingency Plan ==		== Contingency Plan ==

	None necessary, revert to previous release ~~behaviour~~.		None necessary, revert to previous release behavior.

	== Documentation ==		== Documentation ==
	~~Documentation needs to~~ be adjusted.		[http://wiki.sugarlabs.org/go/Development_Team/Almanac/Activity_Bundles#.info_file_format The activity.info file documentation] will be adjusted accordingly once this feature has landed. The discussion about this feature has been taking place at this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html thread] on the sugar-devel mailing list.

	== Release Notes ==		== Release Notes ==

FGrose at 12:57, 7 October 2010

2010-10-07T12:57:38Z

← Older revision		Revision as of 08:57, 7 October 2010
Line 1:		Line 1:
	<noinclude>{{Dated\|See this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html discussion thread] for more up-to-date information}}		<noinclude>{{Dated\|See this [http://www.mail-archive.com/sugar-devel@lists.sugarlabs.org/msg16943.html discussion thread] for more up-to-date information.}}
	[[Category:Feature Accepted 0.88]]		[[Category:Feature Accepted 0.88]]
	[[Category:Feature\|Dotted Activity Versions]]		[[Category:Feature\|Dotted Activity Versions]]