Bug 355887 – The EGit install guide is lacking details for noobs

Bug 355887 - The EGit install guide is lacking details for noobs


Summary:	The EGit install guide is lacking details for noobs

Status:	NEW

Product:	EGit
Classification:	Technology
Component:	Core
Version:	unspecified
Hardware:	All All

Importance:	P3 enhancement (vote)
Target Milestone:	---
Assigned To:	Project Inbox
QA Contact:

URL:
Whiteboard:
Keywords:

Depends on:
Blocks:
	Show dependency tree

Reported:	2011-08-25 14:14 EDT by Dan Bolser
Modified:	2011-08-25 14:18 EDT (History)
CC List:	1 user (show)

See Also:

Attachments
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 Dan Bolser

2011-08-25 14:14:46 EDT

Build Identifier: na

Hi, I think there should be a page of install instructions for EGit, or a least a link to some general install instructions. OK, your all 1337, but I'm noob.

Starting here:
http://eclipse.org/egit/download/

I used 'Help' -> 'Install New Software' -> 'Add':
http://download.eclipse.org/egit/updates

OK, but now I'm confused by the different components:
EGit # OK
EGit - Source # OK
EGit Mylyn GitHub Feature # Wha?
JGit # Do I need this?
JGit - Source # OK
EGit Mylyn # Wha?


So trial and error got me through, but it's confusing, for example, I think I want GitHub stuff, so I clicked 'EGit Mylyn GitHub Feature', but then I get the following error:

Cannot complete the install because one or more required items could not be found.
  Software being installed: Eclipse EGit Mylyn GitHub Feature 1.0.0.201106220257-r (org.eclipse.mylyn.github.feature.feature.group 1.0.0.201106220257-r)
  Missing requirement: Eclipse EGit Mylyn GitHub Feature 1.0.0.201106220257-r (org.eclipse.mylyn.github.feature.feature.group 1.0.0.201106220257-r) requires 'org.eclipse.mylyn.tasks.core 3.2.0' but it could not be found


I'm sure this is easy to fix, but without any documentation, it's confusing. Just a few lines of text at the above location would be a huge help.

Thanks for help,
Dan.

Reproducible: Always

Comment 1 Remy Suen

2011-08-25 14:18:10 EDT

(In reply to comment #0)
> I used 'Help' -> 'Install New Software' -> 'Add':

These steps should probably be mentioned on the page somewhere. Alternatively we can link to the Eclipse help somewhere directly. It should probably also be mentioned on the user guide in the wiki. Right now the wiki assumes the user already has EGit installed.

> EGit Mylyn GitHub Feature # Wha?

We should probably have a link to Mylyn's website somewhere for context.