Hi all,
We have a long standing issue around our documentation which is sort-of
messy and to a big extent outdated and mostly incomplete. I have been
thinking about this an propose a rigorous reorganization of our site
along these general lines:
* Home Page - general introduction to Sling and its goals in terms of
JCR, OSGi, etc.
* Documentation - descriptive documentation style of major
constituents
* First Steps - from Betrand's "15 minutes to Sling" entry
* JCR - How Sling uses and integrates with JCR (embedded,
remote, Session pooling)
* Resources - Extended from current Guides/Resources
* Servlets & Scripts - Extended from current Guides/Servlet
Resolution
* Request Processing - Merge existing Request Processing and
Guides/Request Parmeters
* Filters - What about request filtering (new)
* Eventing & Jobs
* Advanced Topics - if you want to know more and dig deeper
* Sling API - complete description of the API
* Architecture
* Logging in general and Request logging
* Initial Provisioning and Startup
* Configuration
* JCR Content loading and Node Type "Management"
* Object Content Mapping support (OCM)
* Dispatching Requests
* Installing and Updating Bundles
* Implementing a ResourceProvider (new)
* Using ScriptEngines from scripting.dev.java.net (new)
* Development
* Getting and buidling Sling
* JCR-based: WebDAV, JCR plugin for Eclipse, Bunkai (?)
* Bundles - How to create bundles and provide services and
scripts
* Maven Sling Plugin
* Maven JspC Plugin
* Links
* Wiki - links to SLING wiki
* FAQ - links to FAQ on SLING wiki
* Project
* Project Team
* Roles and Processes
* License
Most of this documentation already exists but is outdated. Some of this
needs to be created (mostly marked with "new").
I will start to reorganize the source of our site in the SLINGxWIKI and
disable the synchronization with the real site for now. As soon as the
main page reorganization is done, I will reenable the site
synchronization to get the site updated again.
Feedback as always welcome and nothing is cast in stone ;-)
Regards
Felix
