AW: Revision of Sling documentation, determining old stuff
Sorry, as a little buit confused, autoInstallBundle is certainly a profile... but can you give me a short description about the uploading feature, or can I find any information somewhere else? best regards mike > >>> snip snap > > > - XSLT Processing Pipeline (seems to be ok) [8] > > > - Maven Sling Plugin (can someone check) [9] > > > > This page might be incomplete because the latest version of > the plugin > > supports uploading bundles into the repository to support the JCR > > Install functionality. > > > > Do you mean the autoInstallBundle feature?
AW: Revision of Sling documentation, determining old stuff
>>> snip snap > > - XSLT Processing Pipeline (seems to be ok) [8] > > - Maven Sling Plugin (can someone check) [9] > > This page might be incomplete because the latest version of the plugin > supports uploading bundles into the repository to support the JCR > Install functionality. > Do you mean the autoInstallBundle feature? best regards mike
Re: Revision of Sling documentation, determining old stuff
Hi, Mike Müller schrieb: > Hi > > I'm reviewing the documentation on the Sling Site and need your help > do determine old stuff, because I'm not sure if they are up-to-date or not. > > So please give me some feedback on the following pages: > > - Architecture (seems to be up-to-date) [1] Yes, this is up to date, since it has only recently been written by me. > - Eventing and Jobs (can someone check) [2] > - Internationalization Support (can someone check, seems to be outdated, > at least there's no getLocale() on SlingHttpServletRequest) [3] > - Installing and Upgrading Bundles (can someone check seems to be outdated > in favour of Felix management console) [4] While the contents is still correct (except for the reference to Sling Web Console instead of the Felix Web Console), this page should probably be dropped. Maybe we should just create a general page on system managament and refer to various options like the Felix Web Console or the Felix Shell (soon there will be a standardized Shell) > - Assembly (can someone check, seems not to be part of Sling, maybe CRX) [5] It was part of Sling and is now in the whiteboard. This mechanism predates our knowledge about the OSGi Deployment Admin Service and was an attempt to mimick Eclipse Features. I agree with Bertrand, that we should drop this page. > - Apache Sling Rewriter (maybe ok, but can't find > org.apache.sling.rewriter.*) [6] > - Groovy Support (seems to be ok) [7] We might want to drop this page. Since Groovy 1.6 the groovy library is a bundle and can directly be deployed into any OSGi Container and is also supported by Sling. We even included it in the standard Sling 5 binary. > - XSLT Processing Pipeline (seems to be ok) [8] > - Maven Sling Plugin (can someone check) [9] This page might be incomplete because the latest version of the plugin supports uploading bundles into the repository to support the JCR Install functionality. HTH Regards Felix
Re: Revision of Sling documentation, determining old stuff
Hi, Bertrand Delacretaz schrieb: >> - Internationalization Support (can someone check, seems to be outdated, >> at least there's no getLocale() on SlingHttpServletRequest) [3] > > Correct. IMHO a typical example of a page that needs to have less > details, to stand a better chance of staying in sync with the code. I don't agree here. We don't expect casual Sling users/programmers to read our code in-depth. Otherwise we would not need a documentation site. Of course we could now point to the published JavaDoc. And as said on the page, the getLocale() and getLocales() method is inherited from the ServletRequest interface and hence certainly not duplicated in the SlingHttpServletRequest interface. IIRC I wrote this page with the actual extensions/i18n bundle in mind. So this page is probably rather up to date. Regards Felix
Re: Revision of Sling documentation, determining old stuff
Hi Mike, On Tue, May 12, 2009 at 10:24 PM, Mike Müller wrote: > So please give me some feedback on the following pages: > > - Architecture (seems to be up-to-date) [1] Looks good > - Eventing and Jobs (can someone check) [2] Looks good to me but Carsten is the man > - Internationalization Support (can someone check, seems to be outdated, > at least there's no getLocale() on SlingHttpServletRequest) [3] Correct. IMHO a typical example of a page that needs to have less details, to stand a better chance of staying in sync with the code. > - Installing and Upgrading Bundles (can someone check seems to be outdated > in favour of Felix management console) [4] Agreed, should point to http://felix.apache.org/site/apache-felix-web-console.html instead > - Assembly (can someone check, seems not to be part of Sling, maybe CRX) [5] We are not using assemblies anymore AFAIK, page should be removed? > - Apache Sling Rewriter (maybe ok, but can't find > org.apache.sling.rewriter.*) [6] AFAIK the code is still under https://svn.eu.apache.org/repos/asf/incubator/sling/whiteboard/rewriter > - Groovy Support (seems to be ok) [7] Looks good, didn't check the details. > - XSLT Processing Pipeline (seems to be ok) [8] Looks good, didn't check the details. > - Maven Sling Plugin (can someone check) [9] Looks good, didn't check the details. > - Maven JspC Plugin (can someone check) [10] Don't know enough to say. > BTW I didn't get why the new Sling release is Sling 5 and not Sling 4... Release 4 was broken so we didn't release it. Thanks for your investigations! -Bertrand > [1] http://incubator.apache.org/sling/site/architecture.html > [2] http://incubator.apache.org/sling/site/eventing-and-jobs.html > [3] http://incubator.apache.org/sling/site/internationalization-support.html > [4] > http://incubator.apache.org/sling/site/installing-and-upgrading-bundles.html > [5] http://incubator.apache.org/sling/site/assembly.html > [6] > http://incubator.apache.org/sling/site/rewriting-the-output-through-pipelines.html > [7] http://incubator.apache.org/sling/site/groovy-support.html > [8] http://incubator.apache.org/sling/site/xslt-processing-pipeline.html > [9] http://incubator.apache.org/sling/site/sling.html > [10] http://incubator.apache.org/sling/site/jspc.html > >
Revision of Sling documentation, determining old stuff
Hi I'm reviewing the documentation on the Sling Site and need your help do determine old stuff, because I'm not sure if they are up-to-date or not. So please give me some feedback on the following pages: - Architecture (seems to be up-to-date) [1] - Eventing and Jobs (can someone check) [2] - Internationalization Support (can someone check, seems to be outdated, at least there's no getLocale() on SlingHttpServletRequest) [3] - Installing and Upgrading Bundles (can someone check seems to be outdated in favour of Felix management console) [4] - Assembly (can someone check, seems not to be part of Sling, maybe CRX) [5] - Apache Sling Rewriter (maybe ok, but can't find org.apache.sling.rewriter.*) [6] - Groovy Support (seems to be ok) [7] - XSLT Processing Pipeline (seems to be ok) [8] - Maven Sling Plugin (can someone check) [9] - Maven JspC Plugin (can someone check) [10] BTW I didn't get why the new Sling release is Sling 5 and not Sling 4... best regards mike [1] http://incubator.apache.org/sling/site/architecture.html [2] http://incubator.apache.org/sling/site/eventing-and-jobs.html [3] http://incubator.apache.org/sling/site/internationalization-support.html [4] http://incubator.apache.org/sling/site/installing-and-upgrading-bundles.html [5] http://incubator.apache.org/sling/site/assembly.html [6] http://incubator.apache.org/sling/site/rewriting-the-output-through-pipelines.html [7] http://incubator.apache.org/sling/site/groovy-support.html [8] http://incubator.apache.org/sling/site/xslt-processing-pipeline.html [9] http://incubator.apache.org/sling/site/sling.html [10] http://incubator.apache.org/sling/site/jspc.html