AW: Revision of Sling documentation, determining old stuff

2009-05-15 Thread Mike Müller
 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


AW: Revision of Sling documentation, determining old stuff

2009-05-15 Thread Mike Müller
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?


Re: Revision of Sling documentation, determining old stuff

2009-05-13 Thread Bertrand Delacretaz
Hi Mike,

On Tue, May 12, 2009 at 10:24 PM, Mike Müller mike...@mysign.ch 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




Re: Revision of Sling documentation, determining old stuff

2009-05-13 Thread Felix Meschberger
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

2009-05-13 Thread Felix Meschberger
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



Revision of Sling documentation, determining old stuff

2009-05-12 Thread Mike Müller
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