[ http://issues.apache.org/jira/browse/JS2-83?page=comments#action_12358074
]
David Le Strat commented on JS2-83:
-----------------------------------
As part of this exercise, I would like to propose reorganizing the
documentation structure a bit:
1. We should differentiate the role of the main site from the role of the
subprojects sites. I propose that we locate each subproject documentation in
the matching component xdocs. For instance, profiler goes into
/components/profiler/xdocs. Each subproject has a PDF document that can be
exported for the relevant section. The subproject documentation focus on the
implementation aspects of a specific component.
The role of the main site is to provide guidance in locating the documentation
for each component and to provide reference docs that cut across components.
2. I would like to reorganize the main docs navigation as follow:
Essentials
Features
Installation
Getting Started
Subprojects
Download
Binaries
Source Code
Documentation
Documentation Guides -> Links to a page with an organized list of
documentation guides - The guides provide a quick list of references/links to
resources around a specific topic, when necessary the guide will link to the
relevant documentation in the sub project. For instance Guide to Developing
Portlets, Guide to Customizing Pages, Guide to Jetspeed Pipeline, etc.
Jetspeed API
Jetspeed Plugin
Key Components
Profiler
Page Manager
Security
etc.
These are links to the subproject pages from the main page. Another option is
to centralize those into a Guide to J2 Components (see above) and a better
option in my opinion.
About J2
FAQ
For J1 Users
Supporting Projects (Bridge, Pluto, Apache DS, Derby, Maven, etc...)
Who Uses J2
Portlets Community
How to Help
Support
Mailing List
Bug Database
Wiki
Quality Testing
Source Code Repository
I look forward to your input. Once we have a consensus on the docs structure,
I will start putting the pieces in place.
We already started to track the larger documentation effort under
http://issues.apache.org/jira/browse/JS2-389
Once we are in agreement on the structure I will create additional subtasks for
people to sign up in the parent task.
> Site Documentation, Architectural Overview
> ------------------------------------------
>
> Key: JS2-83
> URL: http://issues.apache.org/jira/browse/JS2-83
> Project: Jetspeed 2
> Type: Task
> Components: Site Documentation
> Versions: 2.0-FINAL
> Reporter: David Sean Taylor
> Assignee: David Le Strat
> Fix For: 2.0-FINAL
>
> Architectural Overview of Jetspeed-2, publish to Jetspeed-2 site
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
