Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 318303 - New p2 repos on Eclipse download need documentation
Summary: New p2 repos on Eclipse download need documentation
Status: RESOLVED WORKSFORME
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Releng (show other bugs)
Version: 3.6   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 3.7 M3   Edit
Assignee: Platform-Releng-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-06-29 08:23 EDT by Daniel Krügler CLA
Modified: 2010-10-14 15:59 EDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Daniel Krügler CLA 2010-06-29 08:23:19 EDT
Build Identifier: I20100608-0911

Since Eclipse 3.6 at least the download provided for examples, specifically the download org.eclipse.sdk.examples-3.6.zip from

http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/index.php

uses the new p2 repository which requires a specific installation procedure. E.g.
you can no longer unzip the download into the Eclipse installation and restart with -clean. This change in distribution is far from obvious even for experienced users and the occurring error

Unable to find feature.xml in directory: C:\Program Files\Eclipse_3.6.x\features\org.eclipse.sdk.examples_3.3.0.v20100527-817fFcfFEdcVbpRlgyBRcVX.jar

does not make the problem much clearer. Worse, even those how try to install such a zip file as archive site get the irritating message that "There are no categorized items" because the filter "Group items by category" is active per default (which is probably a different issue)
IMO all downloads provided on the Eclipse download page, that require explicit installation, need to document this requirement clearly.

 

Reproducible: Always

Steps to Reproduce:
Check the documentation of the individual downloads on

http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/index.php
Comment 1 Kim Moir CLA 2010-06-29 09:17:44 EDT
Does the documentation here not describe the process accurately?  If you click the plus sign at the end of the "Example plug-ins" heading, you'll see this documentation.

http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/details.php#ExamplePlugins
Comment 2 Daniel Krügler CLA 2010-06-29 09:28:26 EDT
(In reply to comment #1)
> Does the documentation here not describe the process accurately?  If you click
> the plus sign at the end of the "Example plug-ins" heading, you'll see this
> documentation.
> 
> http://download.eclipse.org/eclipse/downloads/drops/R-3.6-201006080911/details.php#ExamplePlugins

I agree that this documentation is full-descriptive, but I would disagree that the documentation is easy to find. In fact, I wasn't aware of that until you pointed it out to me. I don't expect that a new user will notice the difference by just visiting this page and clicking the download button "as usual". IMO the differences should be much clearer. Currently it has a similar effect as changing a file format from text format to binary format and wondering that interpreting something as text does no longer work. This example is just figurative, but from a users point of view this change is of similar rank.
Comment 3 Kim Moir CLA 2010-09-02 10:45:45 EDT
Could you describe how the page could be made better?  The expectation is that most downloads are repos these days.
Comment 4 Kim Moir CLA 2010-10-14 15:59:23 EDT
Closing. Please re-open if required.