Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 318823 - Workbench User Guide - Deadly wrong documentation provoking data loss of preconfigured perspectives
Summary: Workbench User Guide - Deadly wrong documentation provoking data loss of prec...
Status: RESOLVED FIXED
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Doc (show other bugs)
Version: 3.6   Edit
Hardware: All All
: P3 normal (vote)
Target Milestone: 3.7 M1   Edit
Assignee: Dani Megert CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-07-04 17:33 EDT by Daniel Alvarez Arribas CLA
Modified: 2010-07-05 04:09 EDT (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Daniel Alvarez Arribas CLA 2010-07-04 17:33:36 EDT
Build Identifier:  20100617-1415

The Workbench User Guide Tutorial at

Getting Started->Basic Tutorial->Perspectives->Saving Perspectives

advises to change the default configuration of the resource perspective,
trying to reverse the changes later. Unfortunately, reversing the changes
won't work. So you could end up with a broken layout just by following the docs.


The docs explain:

"While the Resource perspective has been changed, there is a way to get back the original layout. To reset the Resource perspective to its original layout:

1. Choose Window > Preferences.

2. Expand General and select Perspectives.

3. Select Resource (default) > Make Default and then click OK."

First of all, there is no perspective called "Resource (default)", because in Eclipse IDE for Java EE the Resource perspective is simply not the default (the Java perspective would be).

Anyway...

"4. Any changes to the saved state of the perspective has now been undone. To update the current copy of the Resource perspective that is being worked with, also choose Window > Reset Perspective from the Workbench's menu bar. "


This is ridiculous. Just making it the default perspective (which it seemed to be anyway) will certainly not reverse the layout changes saved in the Resource perspective before. I tried it and the changes have definitely not been reversed.

I think they simply meant to click the "Reset" button, which indeed would reset the perspective to its factory settings, but this way it is plainly wrong, because they ,picked the wrong button, which does something completely unrelated and will no way reverse the changes to the perspective's layout.



Reproducible: Always

Steps to Reproduce:
1. Start Eclipse Helios (I use Eclipse IDE for Java EE)
2. On the Welcome page click "Overview", then "Workbench Basics"
3. Go to Getting Started->Basic Tutorial->Perspectives->Saving Perspectives
4. There you are.
Comment 1 Dani Megert CLA 2010-07-05 04:09:07 EDT
Fixed in /org.eclipse.platform.doc.user/gettingStarted/qs-43e.htm