Bug 465790 - Update PDE Tips & Tricks for Mars (4.5)
Summary: Update PDE Tips & Tricks for Mars (4.5)
Status: VERIFIED FIXED
Alias: None
Product: PDE
Classification: Eclipse Project
Component: Doc (show other bugs)
Version: 4.5   Edit
Hardware: All All
: P3 enhancement (vote)
Target Milestone: 4.5 RC3   Edit
Assignee: Noopur Gupta CLA
QA Contact:
URL:
Whiteboard:
Keywords: Documentation
Depends on:
Blocks:
 
Reported: 2015-04-29 06:13 EDT by Noopur Gupta CLA
Modified: 2015-05-28 05:22 EDT (History)
2 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Noopur Gupta CLA 2015-04-29 06:13:52 EDT
Update PDE T&T document with relevant items from Mars (4.5) N&N documents.
Comment 1 Noopur Gupta CLA 2015-05-15 03:45:57 EDT
Added the following from N&N docs:
- Collect download statistics for your product
- Set default preference values for your product

Released with:
http://git.eclipse.org/c/platform/eclipse.platform.common.git/commit/?id=c0012edd397a2727301713e0594b3e245ab49e7f

Vikas, let me know if you want any other item also to be added to the T&T document.
Comment 2 Vikas Chandra CLA 2015-05-25 12:37:45 EDT
I had a look of all 100+ defects that went into PDE for 4.5.

Not too sure of 

>>Collect download statistics for your product

Using reload button, as a workaround or trick for many situations an user can get into while dealing with target editor would be a decent T&T item.
Comment 3 Vikas Chandra CLA 2015-05-25 12:52:21 EDT
For 
>>Set default preference values for your product

I think we need to provide some context. I'm not suggesting the following text but just providing the context for this T&T item.


While creating a product, many times default preferences needs to be specified. Earlier that was done by exporting the preference page
and then manually adding the preferences to the customization file ( after doing some processing). Now there is a "Convert Preference Wizard" option in customization tab of product editor.
Comment 4 Vikas Chandra CLA 2015-05-25 13:15:58 EDT
Specify baseline via target may also qualify for T&T since it is new and not something very obvious for 4.4 user.
Comment 5 Noopur Gupta CLA 2015-05-26 03:14:08 EDT
(In reply to Vikas Chandra from comment #2)
> I had a look of all 100+ defects that went into PDE for 4.5.
> 
> Not too sure of 
> 
> >>Collect download statistics for your product

Do you want to remove this item?

> Using reload button, as a workaround or trick for many situations an user
> can get into while dealing with target editor would be a decent T&T item.

Do you mean to include the feature "Reload button added in target editor" from 4.5 M5 N&N doc?

(In reply to Vikas Chandra from comment #3)
> For 
> >>Set default preference values for your product
> 
> I think we need to provide some context. I'm not suggesting the following
> text but just providing the context for this T&T item.
> 
> 
> While creating a product, many times default preferences needs to be
> specified. Earlier that was done by exporting the preference page
> and then manually adding the preferences to the customization file ( after
> doing some processing). Now there is a "Convert Preference Wizard" option in
> customization tab of product editor.

I will update it based on the context given above.

(In reply to Vikas Chandra from comment #4)
> Specify baseline via target may also qualify for T&T since it is new and not
> something very obvious for 4.4 user.

This feature is directly visible in the UI when user clicks "Add Baseline..." button and can't be missed by the user. Hence, it is not a tip/trick in my view, and is a new useful feature which is mentioned in the What's new doc for 4.5. Let me know if you want to include it in the T&T doc also.
Comment 6 Vikas Chandra CLA 2015-05-26 03:28:47 EDT
> Do you want to remove this item?

I think we can do away with it. If we want to keep this, lets put it as the last item.

>Do you mean to include the feature "Reload button added in target editor" 

Yes, with context - many times target editor's state goes in limbo and it is impossible to get it to resolved condition without manually editing the target editor file ( increase sequence number). The user is kind-of stuck.

>>Hence, it is not a tip/trick in my view, and is a new useful feature which is >>mentioned in the What's new doc for 4.5

Sort of agree here but I'll still suggest we should keep it. Reason - it is not very obvious and something of importance.
Comment 7 Noopur Gupta CLA 2015-05-26 08:32:33 EDT
Updated the T&T doc based on comments from Vikas and released:

http://git.eclipse.org/c/platform/eclipse.platform.common.git/commit/?id=c574eb4cee5dea98d2b9e54d6f700ac3b8b93188

- Removed "Collect download statistics for your product"
- Added "Reload button in target editor"
- Updated "Set default preference values for your product"
- Added "Create an API Baseline from a Target Definition"
Comment 8 Noopur Gupta CLA 2015-05-28 05:20:26 EDT
Fixed as per comment #7.
Comment 9 Noopur Gupta CLA 2015-05-28 05:22:11 EDT
Verified with Eclipse 4.5 I20150526-2010.