Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 441698

Summary:	The release notes document is badly organized
Product:	[Modeling] Sirius	Reporter:	Pierre-Charles David <pierre-charles.david>
Component:	Documentation	Assignee:	Projet Inbox <sirius.doc-inbox>
Status:	CLOSED FIXED	QA Contact:	Pierre-Charles David <pierre-charles.david>
Severity:	enhancement
Priority:	P3	CC:	esteban.dugueperoux
Version:	1.0.0	Keywords:	triaged
Target Milestone:	3.0.0
Hardware:	All
OS:	All
See Also:	https://git.eclipse.org/r/48878 https://git.eclipse.org/c/sirius/org.eclipse.sirius.git/commit/?id=24523441624b7cca1b8f5f93631dd526902680fe
Whiteboard:

Description Pierre-Charles David

2014-08-13 10:03:18 EDT

The current release notes document is a long list of technical changes, some trivial change that will impact almost no-one, some really important ones that almost all users shoud be aware of. The current way the document is organized make it almost impossible for a user to distinguish what is important or not, what will be be the impact on him/her if s/he upgrades, and what action (if any) s/he must take to adopt a new version.

We should rethink the structure of the document with users/readers needs in mind, and allow us to highlight "New & Noteworthy" features and changes in each release without drowning the reader with heaps of details about minor code changes.

Comment 1 Eclipse Genie

2015-05-29 04:13:33 EDT

WARNING: this patchset contains 3990 new lines of code and may require a Contribution Questionnaire (CQ) if the author is not a committer on the project. Please see:https://wiki.eclipse.org/Project_Management_Infrastructure/Creating_A_Contribution_Questionnaire

Comment 2 Eclipse Genie

2015-06-01 03:38:08 EDT

Gerrit change https://git.eclipse.org/r/48878 was merged to [master].
Commit: http://git.eclipse.org/c/sirius/org.eclipse.sirius.git/commit/?id=24523441624b7cca1b8f5f93631dd526902680fe

Comment 3 Pierre-Charles David

2015-06-01 05:13:46 EDT

While not perfect (we'll certainly continue to tweak it), the new version just commited is already much better than before.

Comment 4 Pierre-Charles David

2015-06-24 11:12:23 EDT

Available in Sirius 3.0.0. See https://wiki.eclipse.org/Sirius/3.0.0.