I would add a whole bunch of short intros from various perspectives
that answer these questions for the beginner:
- Sling in a few words (like the 15 min by Bertrand but just for
reading without coding)
- Why should I care with yet another webapp framework? (getting ready
for flame-wars ;-) )
- Sling + REST (for the beginner, with lots of REST explainations)
- Sling + REST for the RESTafarian
.....
IMHO this will be the most important part of the communication because
people don't know (and have to be convinced) that Sling is kind of the
next-generation of web application frameworks (eg. RoR is currently
state of the art with lots of dev support like scaffolding, but Sling
brings in the concept of resources and REST etc.). BTW, this could be
another intro or article:
- evolution of web application frameworks (mainly history)
I can think of a nice matrix here ;-)
I have some notes for two intros and will post them to the wiki soon.
Alex
Am 13.02.2008 um 15:31 schrieb Felix Meschberger:
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
--
Alexander Klimetschek
[EMAIL PROTECTED]
