Bug 288852 - A cheatsheet for creating your first assignment
Summary: A cheatsheet for creating your first assignment
Status: RESOLVED FIXED
Alias: None
Product: z_Archived
Classification: Eclipse Foundation
Component: IDE4EDU (show other bugs)
Version: unspecified   Edit
Hardware: PC Linux
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: Project Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords: helpwanted
Depends on:
Blocks:
 
Reported: 2009-09-08 14:29 EDT by Wayne Beaton CLA
Modified: 2014-01-09 15:38 EST (History)
2 users (show)

See Also:


Attachments
New project/bundle to provide introductory cheatsheets. (3.87 KB, patch)
2009-09-27 11:54 EDT, Maciej Kozlowski CLA
wayne.beaton: iplog+
Details | Diff
mylyn/context/zip (3.30 KB, application/octet-stream)
2010-01-12 16:35 EST, 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 2009-09-08 14:29:11 EDT
This cheatsheet can guide the student through the process of creating their first project and class with the JavaLite perspective.
Comment 1 Maciej Kozlowski CLA 2009-09-14 01:04:28 EDT
I will work on this for the 1st code sprint
Comment 2 Maciej Kozlowski CLA 2009-09-27 11:54:18 EDT
Created attachment 148203 [details]
New project/bundle to provide introductory cheatsheets.

Here's my patch for the bug. 
However I found something interesting while testing the cheat sheet. When the 'new project wizard' or 'new class wizard' is open the main Eclipse application loses focus and the user can't click through the cheat sheet steps. With this patch I made the cheat sheet so that for each wizard all the steps are visible at once, this way the user doesn't need to click through the cheat sheet. The zip file contains my entire Eclipse project.
Comment 3 Cory Matheson CLA 2010-01-12 15:01:42 EST
I tested the patch, and it does indeed add a new cheat sheet, which the user is able to follow. I'm unsure what Maciej means by making all steps visible at once, as the cheat sheet's instructions tell you to "click once done" (meaning the modal window is closed, and they can continue clicking the cheat sheet).

I have a couple comments / concerns however:
1. The patch is a standalone eclipse project... will this need to be integrated into a different project / package?
2. I noticed a small spelling mistake in cheat sheet title. "Cheat sheet for creating a new Project and class" - I think it should probably be a lower case "p" instead. I notice this done elsewhere in the cheat sheet too.
Comment 4 Wayne Beaton CLA 2010-01-12 15:40:41 EST
Deciding when to create a separate plug-in is a bit of an art form. By having separate plug-ins, you gain some flexibility to decide what bits of the functionality you want to actually deploy. On the other hand, management becomes more challenging. Also, putting functionality into separate plug-ins really forces you to think about the APIs that you expose which has potential to make the base plug-ins even more useful.

I'd prefer to keep the cheatsheets separate from the rest of the code as much as is possible.

Is this patch, in your opinion, something we should commit and use as a basis for further development? It doesn't need to be perfect so long as it's something that we can evolve.
Comment 5 Cory Matheson CLA 2010-01-12 16:00:18 EST
Yup, I think we can definitely work with this patch and make it fit our needs.

My 1 last comment is, the eclipse project is named "Cheatsheet Plugin", so it may need to be refactored to something like org.eclipse.ide4edu.cheatsheetplugin or some such to fit the rest of the plugins? Again, not too 100% sure on how you want this organized.

But it works as advertised, so its probably worth commiting.
Comment 6 Wayne Beaton CLA 2010-01-12 16:35:19 EST
Given that the patch is <250 lines total (and seems to conform to the track started with figure #3 in the IP Due Diligence Process document [1]), I have committed it to CVS.

Before doing so, however, I have renamed the bundle to org.eclipse.ide4edu.javalite.cheatsheets.introductory. I opted for a somewhat lengthy name as a I can envision the creation of additional bundles with alternative cheatsheets. I have further removed the unnecessary Activator and have changed the required runtime environment from Java 1.6 to Java 1.5. We should probably consider reducing this further to Java 1.4.

I will update the Team Project Set and mark the attached patch as iplog+ so that it appears in the project's IP Log.

[1] http://www.eclipse.org/legal/EclipseLegalProcessPoster.pdf
Comment 7 Wayne Beaton CLA 2010-01-12 16:35:22 EST
Created attachment 155931 [details]
mylyn/context/zip
Comment 8 Wayne Beaton CLA 2010-01-12 16:40:47 EST
Team project set updated. Marking as FIXED.