Hey Mike, glad you like my idea, here a first draft of a list which imho would be didactical sense:
- What is Sling - Getting and building Sling - Architecture - Resources - Setting up an Sling-Project with Eclipse [NEW - [1]] - Sling-Taglib (JSP) [NEW - especially sling:include needs good documentation] - Manipulating Content/SlingPostServlet (servlets/post) /** Note: here I think the user knows enogh to get in touch with the JAVA API **/ - Request Parameters - How to create a new bundles and services for Sling - Authentication - Eventing and Jobs I chose the JSP approach since most java developers are familiar with it. All further topics seam to be to specialized or detailed to get started with. I might have forgotten something but more important is if this list is ok for a sling rookie. But as always the best way to check some documentation is to contact a good old friend havin nothing done with Sling yet - let him get in touch with sling in exact this order and allow him to ask questions, we should get pretty soon get a feeling if the order is not the best or if a topic isn't handled well for a rookie (may be not enogh or to complex). Hope this helps a bit. Best regards, Dominik [1] - not building sling from source and more information then just "copy from example project" but just raw contentloader approach with the information how to manipulate nodes through json or xml files - bundles/services should be handled later On Sat, May 23, 2009 at 4:40 PM, Mike Müller <[email protected]> wrote: > Hio Dominik > > > I like the idea of an overview page (the new "documentation" > > parent page) > > with a "hot topics" or better "Getting Started" box with a > > roadmap of links > > the user can follow to get a good overview of Sling. This > > would allow to > > have a technically correct hierarchy, but supporting > > newcommers who have no > > clue how Sling is organized and where to start. > > > > WDYT? > > That's mostly what I do have in mind: "Getting Started" is the > first main navigation under "Documentation". Beside some "real" > content like "What is Sling" and "Discover Sling in 15 minutes" > I like your idea to deliver a list of links/a roadmap which > will point out the most important docu pages in a meaningful > order. > > Have you any suggestions for the topics which should be listed > there? You can have a look at the new structure on [1] to pick > out docu pages or list new topics which aren't yet integrated in > my structure. > > [1] http://markmail.org/message/7vu63i7rketgdozi > > best regards > mike >
