Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Bug 108785

Summary: Link to "documentation" in navigation bar
Product: Community Reporter: Nicolai Czempin <n.czempin>
Component: WebsiteAssignee: phoenix.ui <phoenix.ui-inbox>
Status: RESOLVED WONTFIX QA Contact:
Severity: major    
Priority: P3 CC: webmaster
Version: unspecified   
Target Milestone: ---   
Hardware: All   
OS: All   
Whiteboard:
Bug Depends on: 134275    
Bug Blocks:    

Description Nicolai Czempin CLA 2005-09-05 06:57:46 EDT
Please give me a coherent reason why there is a link to documentation on the
start page, but not in the navigation tab on the left (or www.eclipse.org).
Or, alternatively, just include the link (to
http://www.eclipse.org/documentation/main.html).

Ever since I have seen the eclipse.org page for the first time (about three
years ago?) I assumed this was a minor oversight and would be corrected soon. I
guess I was wrong. So now I'm assuming there must be a good reason to exclude
the link; I just can't think of one.
Comment 1 Susan Iwai CLA 2005-09-07 15:04:16 EDT
(In reply to comment #0)
> Please give me a coherent reason why there is a link to documentation on the
> start page, but not in the navigation tab on the left (or www.eclipse.org).
> Or, alternatively, just include the link (to
> http://www.eclipse.org/documentation/main.html).
> 
> Ever since I have seen the eclipse.org page for the first time (about three
> years ago?) I assumed this was a minor oversight and would be corrected soon. I
> guess I was wrong. So now I'm assuming there must be a good reason to exclude
> the link; I just can't think of one.

The link to documentation you mentioned is in the nav bar on the Eclipse Project
pages - http://www.eclipse.org/eclipse/index.html  Documentation is provided by
each of the projects individually, linked from their own websites, and is
managed by the project committers. So, the reason, (you can judge if its a good
one), is that the documentation is distributed and that list relates to just one
of the projects.  
Comment 2 Susan Iwai CLA 2005-09-07 15:12:19 EDT
(In reply to comment #1)
That being said, we can move your comment to the Phoenix project as a suggestion
to make documentation links more obvious from the rest of the site ? 
Susan
Comment 3 Eclipse Webmaster CLA 2006-03-17 14:01:03 EST
*** Bug 121285 has been marked as a duplicate of this bug. ***
Comment 4 Eclipse Webmaster CLA 2006-03-31 09:41:53 EST
I think we do need a centralized documentation section on our website - Just like Downloads is a download central, Mailing Lists is a grouping of all the lists, Projects is a grouping of all the projects, Newsgroups is a portal to all the newsgroups...

This could be tied to the Project Status Infrastructure (http://www.eclipse.org/projects/dev_process/project-status-infrastructure.php), where every project defines the link to their respective docs.  We simply create a landing page to aggregate all those links.

D.
Comment 5 Eclipse Webmaster CLA 2006-08-21 09:41:01 EDT
The documentation landing page has been started.

http://www.eclipse.org/documentation/
Comment 6 Eclipse Webmaster CLA 2006-09-05 15:18:24 EDT
IMHO the current work on the Pillars will satisfy this requirement more than an actual landing page.

See http://phoenix.eclipse.org/pillars/enterprise.php for a sample, and bug 155235 for the actual enhancement request.
Comment 7 Eclipse Webmaster CLA 2006-10-06 15:11:18 EDT
As discussed in our team meeting, we won't be adding Documentation to the top navigation.  Each project is responsible for its own documentation resources, and we link to documentation from the home page.

A new documentation landing page has been created, though.  Thanks for the feedback.
Comment 8 Denis Roy CLA 2007-10-10 11:41:22 EDT
Moving to Community/Website