Bugzilla – Full Text Bug Listing
| Summary: | [new uex] create universal intro content | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Product: | z_Archived | Reporter: | Mik Kersten <mik.kersten> | ||||||||||||||
| Component: | Mylyn | Assignee: | Balazs Brinkus <balazs.brinkus> | ||||||||||||||
| Status: | RESOLVED FIXED | QA Contact: | |||||||||||||||
| Severity: | enhancement | ||||||||||||||||
| Priority: | P2 | CC: | wmitsuda | ||||||||||||||
| Version: | unspecified | ||||||||||||||||
| Target Milestone: | 2.0 | ||||||||||||||||
| Hardware: | All | ||||||||||||||||
| OS: | All | ||||||||||||||||
| Whiteboard: | |||||||||||||||||
| Bug Depends on: | |||||||||||||||||
| Bug Blocks: | 359147 | ||||||||||||||||
| Attachments: |
|
||||||||||||||||
|
Description
Mik Kersten
Balazs: what we will need first is a proposal for what should go on this page (it can be very simple to start) and then a patch for a contribution. This should be the best bug to kick off your summer of code project started, so I'm marking it P2. I think it over and I will make the proposal for tomorrow. I thought it over and I made a list of the welcome page's items. * Overview section: Title: Mylar Short description: Learn more about the Mylar task-focused ui Content: A simple, short description of mylar. * Tutorials section: Group title: Mylar Tutorial title: Report an eclipse bug Tutorial Short description: Learn how to report a bug to Eclipse Bugzilla. Tutorial Content: A cheat sheet which uses the Help/Report bug function. Later the tutorials section will be updated, as soon as the cheat sheets are finished. * Samples section: I think this section could be empty. * What's new section: Title: Mylar Short description: Find out about the significant changes made to Mylar Content: "New and noteworthy" from http://www.eclipse.org/mylar/doc/new.php. If this list is proper, I will make a patch. This sounds like a very good first pass Balazs. I suggest that you make a patch which has *very* short overviews of the content, e.g. a sentence for each section. Then commit that as a patch and we can come up with content on this bug. Agreed that the samples section should be empty for now. Regarding the New & Noteworthy, should we copy the content into org.eclipse.mylar.doc (we used to have it there) or can we just point to the web-based new & noteworthy? Fyi the file is mylar/doc/new.html (see integrator ref for checking out the web site from CVS). Regarding the tutorials, I think that the following two are key: 1) Getting started with Task Repositories. Add a query to bugs.eclipse.org for all Mylar P1 and P2 enhancements. This is one of the challenges of getting started, many users won't have a bug to submit, and once they have the repository set up it's quite straightforward to submit bugs. 2) Getting started with the Task-Focused UI. This will show them how to activate a task, click the focus button, Alt+click, and switch tasks. Created attachment 68854 [details]
universal intro patch
Created attachment 68856 [details]
universal intro images
I attached the patch file and the images in a zip file. Before the stable Mylar 2.0 comes out, I will update the new and noteworthy page and images. Created attachment 68862 [details]
mylar/context/zip
I forgot to attach the context.
*** Bug 111865 has been marked as a duplicate of this bug. *** Patch applied, great stuff Balazs! Some comments: 1) Make the "Add Task Repository Step" sound optional before "Create a New Query", because we already automatically add the Eclipse.org repository. However, it would be useful to have a step to prompt users to set the credentials for that repository (repository page now has a hyperlink for doing that). 2) It would help to simplify the "Use Task Focused UI" steps some. First, do not suggest to switch to the PDE perspective because we try not to favor particular perspectives. Open Task List view should be executable. Then, instead of having the user create a new project, you could get them to activate a task and then do an "Open Type" on a Java type that they have in an existing project (or suggest creating a project if they don't). Then the key thing to get them to do is to toggle the Focus button on the Package Explorer (you can probably make that executable too) and to get them to Alt+click when toggled (since it takes a while for users to learn this). Another thing I'm wondering is if we should really be redistributing the New & Noteworthy. We used to do this, but the online documentation has been working better. What do you think? I will do the modifications. We can use the online New & Noteworthy, but when I made the local page I followed the "general" eclipse style. If we use the online version I would like to use it as a local version, in the help system. I wouldn't like to use a simple link which opens in a web browser. If we choose the "general" version I can write a small shell script to make the rewriting faster. I've tried to open Overview page from Welcome view. I can see Mylar icon there, but when I click on it, new window pops up that shows the following error: HTTP ERROR: 404 ProxyServlet: /help/index.jsp RequestURI=/help/index.jsp Powered by Jetty:// Created attachment 68980 [details]
manifest.mf contains o.e.webapp depencies
Sorry I forgot to add the org.eclipse.help.webapp to the plugin dependencies. You need o.e.help, o.e.help.ui, o.e.help.base, o.e.webapp and org.mortbay.jetty to use the help. Only the webapp isn't added automatically.
I attach the modified manifest.mf file. I hope this will be working.
What is the decision about the "new and noteworthy" page? After the decision I can attach a new patch which contains the modifications. Balazs: could you please make the changes to the manifest file a patch? Regarding the New & Noteworthy, I'm fine with embedding it since it does make sense to link from Welcome. We have a script for copying over the contents in /cvsroot/org.eclipse/www/mylar/build.xml so please update it to copy the contents in the way that you use them. Mik: You wrote in the 10th comment, that Eclipse.org will be automatically added to the repository list. At the moment I can't see it in my list. Is the problem only with my system or it was removed from the list. Might be that you have an old version, or that you don't have the full project set checked out (need mylyn.bugzilla.ide). Run with a clean workspace to verify. Created attachment 71562 [details]
modified cheatsheets
I made the modifications of the cheatsheets.
Created attachment 71563 [details]
mylar/context/zip
Patch applied. Will do a full review of this towards the end of next week and file new bug reports if anything comes up. Can we close this one now? Great that this contribution will be in 2.0 Balazs! Balazs: I made a new 48x48 image that uses the filter/fade metaphor instead of the deprecated "Mylar film" metaphor. What do you think? I think we're done here, and can continue improving the content as we go. Great work Balazs. |