Mailing-List: contact dev-help@directory.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Apache Directory Developers List" <dev@directory.apache.org>
Received-SPF: pass (herse.apache.org: local policy)
DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws;
  s=s1024; d=yahoo.com;
  h=Message-ID:X-YMail-OSG:Received:Date:From:Subject:To:MIME-Version:Content-Type:Content-Transfer-Encoding;
  b=tujR/1OQetNYOyJJ42UGuR/oeuM7qdku0zXctOHr7CBj4t2f8IbJ4aU0rXEfNZraIK9PEPDFTplbbRBJPgSbOTNyeT9hkpDN8+qCshF7Vp/ACaCejEtqDrojoRLj6+Qw2orAQb9WMIH2UMn8KXvCkF2sSIZkvMTiL34l6o7Lwso=
  ;
Message-ID: <20070119183754.86257.qmail@web60722.mail.yahoo.com>
Date: Fri, 19 Jan 2007 10:37:54 -0800 (PST)
From: Ole Ersoy <ole_ersoy@yahoo.com>
Subject: [Documentation] New System Proposal
To: directory apache <dev@directory.apache.org>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Transfer-Encoding: 8bit

Hey Guys,

I just looked into what it would take to
have our documentation reside in the eclipse 
help system.

Here's a link to the document I'm using to describe
the cookbook items for this type of effort:

https://svn.apache.org/repos/asf/directory/sandbox/oersoy/collaboration.platform.documentation/cookbook.apt

In there I've listed the benefits of this approach and

various other cookbook items to get us going.

I'll paste the benefits parts below anyways, since I
believe this will make us more effective.

Cheers,
- Ole


Challenge

     Understanding the benefits of using the eclipse
help system
     for our documentation effort.

Solution

     TODO Fix link later.
     See: 
    
http://directory.apache.org/documentation/collaboration/documentation/benefits

Discussion

     - Simple navigation.
     - Makes sense with respect to the LDAP Studio
eclipse plugin.
     - Ability to check out, update and resubmit
content, structure, and formatting documents.
     - Separation of content and format
     - CSS controlled styling.
     - Separation of content and structure.
     - XML descriptors for structure documents.
     - Ability to work on documentation in tool of
choice.
     - Ability to work in personally chosen
microformat.
     - Subversioned documentation.
     - Quick contribution of individual document to
apacheds.
     - Simplified content management.
     - Better documentation visibility.
     - Integrated lucene based searching.
     - Rapid recreation of documentation in other
formats.
     - One common model for all microformatted
documents.
     - Open source documentation platform for rapid
introduction of new documentation capabilities.
     - Project centric documentation location.
     - Zero effort with integration of apache
documentation into eclipse.


____________________________________________________________________________________
Need Mail bonding?
Go to the Yahoo! Mail Q&A for great tips from Yahoo! Answers users.
http://answers.yahoo.com/dir/?link=list&sid=396546091