Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cross-project-issues-dev] Feature names and descriptions

Chris is still working on it. He'll let us know when he has something to show us via Bug 404861 [1]. I'll update that bug with this information.

In the meantime, I've attached the JSON dump of the information that Chris will be using to populate the page (generated out of downloads/releases/kepler/201305100900/features/).




On 05/14/2013 05:49 AM, Oberhuber, Martin wrote:

Hi Wayne,


Can you provide a preview URL of the packages pages ?


That would greatly help understanding what the final thing will look like, and how my feature’s text blends with other feature’s text.





Martin Oberhuber, SMTS / Product Architect – Development Tools, Wind River

direct +43.662.457915.85  fax +43.662.457915.6


From: cross-project-issues-dev-bounces@xxxxxxxxxxx [mailto:cross-project-issues-dev-bounces@xxxxxxxxxxx] On Behalf Of Wayne Beaton
Sent: Monday, May 13, 2013 9:19 PM
To: cross-project-issues-dev@xxxxxxxxxxx
Subject: [cross-project-issues-dev] Feature names and descriptions


Greetings folks!

We're working on some updates to the packages pages. As part of this, we're going to display actual feature information rather than just a bunch of ids.

e.g on the "details" page for the Eclipse IDE for Java EE Developers [1], instead of showing the feature id, " org.eclipse.jdt", we'll show the feature label, "Eclipse Java development tools (binary runtime and user documentation).".

We haven't quite decided yet, but we may try to work in the description.

I've written a little script to extract this information directly from the features as they exist in the Kepler repository.

I've done a quick review, and have found a few misspelling and some other odd things. Since this information is used in other places, I think that it's pretty important to get it right.

For example, the description for "Acceleo" (org.eclipse.acceleo) is "Acceleo". I'm not sure that this provides anybody with a compelling reason to install this feature.

There are several features with descriptions that seem to assume that the reader will know what it is based on the project name (MoDisco, QVT, and some of the Mylyn subprojects stand out). IMHO, these descriptions should give me a reason to look into the project and find out more.

There are inconsistencies in format as well. Some are a few words or a phrase, some are complete sentences, some are short paragraphs, and some use bullets. I'm a fan of providing one or two sentences (no bullets or newlines) to concisely describe the feature.

Please take a few minutes to look at your feature labels and descriptions to make sure that the information that you're providing is helpful for your intended audience. Please take a few minutes to makes sure that the descriptions use correct spelling and grammar.




Wayne Beaton
Director of Open Source Projects, The Eclipse Foundation
Learn about Eclipse Projects
EclipseCon France 2013

cross-project-issues-dev mailing list

Wayne Beaton
Director of Open Source Projects, The Eclipse Foundation
Learn about Eclipse Projects
          France 2013

Attachment: kepler_features.json
Description: application/json

Back to the top