Hi Mike,

On Fri, May 22, 2009 at 11:08 AM, Mike Müller <mike...@mysign.ch> wrote:
> ...Okay, I scanned the whole docs now (took some time...) and would
> like to restructure things a little bit to make it more easy to
> find the right doc....

Cool, thanks!

See below for a few comments on the new structure.

> NEW:
>
> - Documentation (Overview -> was Documenting Sling [UPDATE])
>  - Getting started
>    - What is Sling [NEW, extracts from existing home]
>    - Discover Sling in 15 minutes [OK]
>    - How Sling uses and integrates with JCR [NEW]

I would prefer "Sling and JCR" as a title for the last item.

>  - Engine, the heart of Sling
>    - Architecture
>    - Resources [UPDATE]
>    - Request Parameters [OK]
>    - Filters [OK]
>    - Dispatching Requests [REWRITE]
>    - Default Mapping and Rendering [REWRITE]
>    - Eventing and Jobs [CHECK] --> Carsten can you have a look at it
>    - Authentication [OK]

I think  "Scripts and Servlets" belongs here somewhere, as a general concept.

>
>  - Development
>    - Getting and building Sling [UPDATE]

Here I would add a "zero-tools development" topic, explaining how to
use Sling with a WebDAV mount for script-based development.

>    - Maven Tips & Tricks [UPDATE]
>    - Setup with Eclipse 3.4 [NEW, from Wiki]
>    - Maven Sling Plugin [UPDATE, got content from Felix]
>    - Maven JspC Plugin [CHECK]
>    - How to create a new bundles and services for Sling [NEW]
>    - Logging [OK] [UPDATE]
>    - RequestProgressTracker [NEW, from SLING-3]
>    - Dependency Management [OK]
>    - Repository Based Development [OK] (lack of Eclipse Plugin)
>
>  - Bundles
>    - MIME Type Support (commons/mime) [OK]
>    - Internationalization Support (extensions/i18n) [UPDATE]
>    - Manipulating Content/SlingPostServlet (servlets/post) [OK]
>    - Content Loading (lack of JSON/XML) (jcr/contentloader) [UPDATE]
>    ... a doc page for each bundle should be the future ambition...
>
>  - Tutorials & How-Tos
>    - Launch Sling (was Provisioning and Startup) [REWRITE]
>    - Installing and Upgrading Bundles [OK] --> link to [1]
>    - ACL/ACE [NEW]
>    - Default Sling JCR layout and nodetypes [NEW]
>    - Implementing a ResourceProvider [NEW]
>    - Apache Sling Rewriter [OK] (Code under whiteboard)
>    - XSLT Processing Pipeline [OK]
>
>  - Wiki
>
>  - configuration (was Configuration Support) [OK]
>
>  - Sling in production
>    - Sling standalone [NEW]
>    - Sling in a Servlet container [NEW]
>    - Sling with Apache httpd [NEW]
>    - Access Logging [NEW]
>
>  - Sling API (JavaDoc) [OK]
>
>
> FAQ [DELETE] -> should rather be integrated into the doc on the
> related themes.

Note sure about that, a general FAQ is good to have.

>... Next steps:
> * give me your input about the new structure and also
>  missing topics...

I'm more worried about a too ambitious plan than missing topics ;-)
But the above looks good.

> * I begin to update the structure and content (and definitifely
>  ask for help from the list for several topics)

Cool

-Bertrand

Reply via email to