Bug 246028 - Need Intro page for IDE4EDU
Summary: Need Intro page for IDE4EDU
Status: RESOLVED FIXED
Alias: None
Product: z_Archived
Classification: Eclipse Foundation
Component: IDE4EDU (show other bugs)
Version: unspecified   Edit
Hardware: PC Windows XP
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Project Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords: bugday, helpwanted
Depends on:
Blocks:
 
Reported: 2008-09-02 22:53 EDT by Wayne Beaton CLA
Modified: 2014-01-09 15:38 EST (History)
3 users (show)

See Also:


Attachments
Welcome page generation (231.65 KB, application/pdf)
2009-10-05 22:07 EDT, Dwight Deugo CLA
no flags Details
Quick try at using the customizable intro. (102.38 KB, application/zip)
2009-10-06 01:08 EDT, Peter Lorimer CLA
wayne.beaton: iplog+
Details
Updated project directory (99.00 KB, application/octet-stream)
2009-10-08 12:34 EDT, Wayne Beaton CLA
no flags Details
mylyn/context/zip (3.42 KB, application/octet-stream)
2009-10-09 15:00 EDT, Wayne Beaton CLA
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Wayne Beaton CLA 2008-09-02 22:53:18 EDT
The features of the IDE4EDU really should of have corresponding intro pages. Pointers to help, and maybe even a cheat sheet or two would be good.
Comment 1 Ian Kennedy CLA 2008-10-13 12:27:50 EDT
(In reply to comment #0)
> The features of the IDE4EDU really should of have corresponding intro pages.
> Pointers to help, and maybe even a cheat sheet or two would be good.
> 

Maybe allow for opening of projects from the welcome screen. Recent local projects could be listed as well as a selection to open a remote project. (https://bugs.eclipse.org/bugs/show_bug.cgi?id=250661)
Comment 2 Wayne Beaton CLA 2009-09-04 11:55:09 EDT
I believe that a good starting point would be a rudimentary welcome page that just describes what the heck IDE4EDU is. After that we can open additional bugs for further functionality.

There is some help in the documentation:

http://help.eclipse.org/galileo/topic/org.eclipse.platform.doc.isv/guide/ua_intro_define_content.htm
Comment 3 Peter Lorimer CLA 2009-10-01 21:11:06 EDT
I would like to start on this for the second sprint.
Comment 4 Wayne Beaton CLA 2009-10-01 23:58:27 EDT
(In reply to comment #3)
> I would like to start on this for the second sprint.

Bring it.

Remember that most of the Eclipse community doesn't know what a "sprint" is. "I will be working on this over the next week" is enough information.
Comment 5 Peter Lorimer CLA 2009-10-02 00:53:00 EDT
Right! I will be working on this over the next week.
Comment 6 Peter Lorimer CLA 2009-10-05 19:41:11 EDT
Should this be extending the universal intro, or should this intro be an intro of its own?
Comment 7 Wayne Beaton CLA 2009-10-05 21:24:34 EDT
(In reply to comment #6)
> Should this be extending the universal intro, or should this intro be an intro
> of its own?

How do you feel about it?
Comment 8 Peter Lorimer CLA 2009-10-05 21:34:32 EDT
I am assuming that all the eclipse made RCPs use the universal intro. I think it is very functional. However, I think that it is over complicated, if were going for simplified. However, creating all new content is a large job if in the end it will be a similar product to the existing universal intro. I am on the fence, I have been going with my gut and working towards a simplified version, from the minimal content example in the help files. However, this won't have the eclipse look that the universal intro has. So here I stay, sitting on the fence.
Comment 9 Wayne Beaton CLA 2009-10-05 21:41:34 EDT
Make a choice and run with it. Post a patch as early as possible to solicit feedback.
Comment 10 Dwight Deugo CLA 2009-10-05 22:04:52 EDT
I have attached a document on how to create the welcome page. It is one Eclipse version old, but it may be close.
Comment 11 Dwight Deugo CLA 2009-10-05 22:07:21 EDT
Created attachment 148846 [details]
Welcome page generation
Comment 12 Peter Lorimer CLA 2009-10-06 01:08:33 EDT
Created attachment 148847 [details]
Quick try at using the customizable intro.

I'm not sure if this is what we're looking for but it's a shot. I'm not really sure I like it yet. I found it hard to maneuver the pseudo-html XML file, and even harder to style with CSS, due to my low-level of experience. One problem I had was the "Go to Workbench" , switchToLaunchBar action-command wouldn't work, with all my trials I only succeeded in failure on that end. I took a look at Dwight's suggestion to create from scratch, and I honestly now think extending the universal intro is the best way to go. Because, I believe it is possible to specify which options are shown i.e. overview, tutorials, etc. The problem with starting from scratch is the lack of content. As mentioned in previous posts we really only need to describe what IDE4EDU is and provide some links to tutorials for now. As it is the Universal intro is very nice looking and my attempt seems feeble in comparison.
Comment 13 Peter Lorimer CLA 2009-10-06 01:19:28 EDT
(In reply to comment #12)
> Created an attachment (id=148847) [details]
> Quick try at using the customizable intro.
> 
> I'm not sure if this is what we're looking for but it's a shot. I'm not really
> sure I like it yet. I found it hard to maneuver the pseudo-html XML file, and
> even harder to style with CSS, due to my low-level of experience. One problem I
> had was the "Go to Workbench" , switchToLaunchBar action-command wouldn't work,
> with all my trials I only succeeded in failure on that end. I took a look at
> Dwight's suggestion to create from scratch, and I honestly now think extending
> the universal intro is the best way to go. Because, I believe it is possible to
> specify which options are shown i.e. overview, tutorials, etc. The problem with
> starting from scratch is the lack of content. As mentioned in previous posts we
> really only need to describe what IDE4EDU is and provide some links to
> tutorials for now. As it is the Universal intro is very nice looking and my
> attempt seems feeble in comparison.

Also, I haven't created any pictures because I'm not 100% sure if I can create images using my educational license of photoshop. Otherwise I would have created an icon atleast. I guess I could use the already created one.
Comment 14 Wayne Beaton CLA 2009-10-08 10:51:55 EDT
Dwight, where did that PDF come from?
Comment 15 Dwight Deugo CLA 2009-10-08 11:19:36 EDT
It was one of my old Eclipse Source articles.
Comment 16 Wayne Beaton CLA 2009-10-08 12:32:27 EDT
I've pulled the plug-in into my workspace. I've removed the Activator (it's not required). In fact, I've removed the Java nature from the project as it's not necessary. I'll attach the changed project for your review.

I'd like to see more content, but it's definitely a good start.
Comment 17 Wayne Beaton CLA 2009-10-08 12:34:29 EDT
Created attachment 149139 [details]
Updated project directory

I've removed the Java code, nature, and builders since they are not required.
Comment 18 Wayne Beaton CLA 2009-10-08 12:51:12 EDT
I'm inclined to change the name of the bundle to org.eclipse.ide4edu.branding and use it as the future target for things like splash screens, icons, and such. Does that make sense?
Comment 19 Dwight Deugo CLA 2009-10-08 12:55:34 EDT
Yes
Comment 20 Peter Lorimer CLA 2009-10-08 16:32:10 EDT
+1
Comment 21 Wayne Beaton CLA 2009-10-09 14:28:42 EDT
I am prepared to rename and commit. I don't think we should include this in the build until the content is matured. 

Is there agreement?
Comment 22 Dwight Deugo CLA 2009-10-09 14:42:58 EDT
I agree.
Comment 23 Wayne Beaton CLA 2009-10-09 15:00:26 EDT
Committed into HEAD.

For completeness, It was created 100% from scratch, is under the terms of the EPL, contains no encryption, and is <250 lines in length.

I have marked the attachment as +iplog so that it appears in the project's IP Log.
Comment 24 Wayne Beaton CLA 2009-10-09 15:00:37 EDT
Created attachment 149272 [details]
mylyn/context/zip
Comment 25 Peter Lorimer CLA 2009-10-09 16:24:26 EDT
Where should I be pulling this content from? I would like to add more content, I just don't know 100% what we should be putting into it? I bet if I looked around on the website I could find some more content no?
Comment 26 Wayne Beaton CLA 2009-10-13 12:55:20 EDT
(In reply to comment #25)
> Where should I be pulling this content from? I would like to add more content,
> I just don't know 100% what we should be putting into it? I bet if I looked
> around on the website I could find some more content no?

We spoke of tutorials that are specific to IDE4EDU. Something like that would be good content. I'm pretty sure we even have a bug for that, but I'm too lazy right now to figure out which one it is.

As it sits, the intro page isn't all that useful. We either need to make it useful, or remove it.

In any case, it'd be nice to see a couple of new bugs open to add specific content.