You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@sling.apache.org by Felix Oghina <fo...@adobe.com> on 2013/05/28 11:00:53 UTC
Latest JavaDoc?
Hi guys,
It's bothering me that the latest javadoc[0] on the sling website is not
really up to date. For example, the ModifiableValueMap[1] does not
appear at all. Is there some other place for this? I don't think it's OK
to have this documentation only on the dev.day.com / CQ website.
Cheers,
Felix
[0]: http://sling.apache.org/apidocs/sling6/index.html
[1]:
http://dev.day.com/docs/en/cq/current/javadoc/org/apache/sling/api/resource/ModifiableValueMap.html
Re: Latest JavaDoc?
Posted by Robert Munteanu <ro...@lmn.ro>.
> So, Adobe CQ is using an unreleased version of Sling? Or it's using released
> bundles that are not yet part of a sling release?
Released bundles which are not part of a released version of the Sling
launchpad.
Robert
>
> On 05/28/2013 11:08 AM, Robert Munteanu wrote:
>>
>> Hi Felix,
>>
>>> It's bothering me that the latest javadoc[0] on the sling website is not
>>> really up to date. For example, the ModifiableValueMap[1] does not appear
>>> at
>>> all. Is there some other place for this? I don't think it's OK to have
>>> this
>>> documentation only on the dev.day.com / CQ website.
>>>
>>> Cheers,
>>> Felix
>>>
>>> [0]: http://sling.apache.org/apidocs/sling6/index.html
>>> [1]:
>>>
>>> http://dev.day.com/docs/en/cq/current/javadoc/org/apache/sling/api/resource/ModifiableValueMap.html
>>
>> The javadoc corresponds to released versions, and Sling 7 is not yet
>> out, see [2] . In the meantime, you can use the javadocs published on
>> the maven repository with each artifact.
>>
>> So if you want the /7/ javadoc, feel free to help us with fixing the ITs
>> ;-)
>>
>> Robert
>>
>>
>> [2]: http://sling.markmail.org/thread/hct2k7ijcnz4pzq7
>>
>>
>> --
>> Sent from my (old) computer
>
>
--
Sent from my (old) computer
Re: Latest JavaDoc?
Posted by Felix Oghina <fo...@adobe.com>.
Hi Robert,
So, Adobe CQ is using an unreleased version of Sling? Or it's using
released bundles that are not yet part of a sling release?
Thanks,
Felix
On 05/28/2013 11:08 AM, Robert Munteanu wrote:
> Hi Felix,
>
>> It's bothering me that the latest javadoc[0] on the sling website is not
>> really up to date. For example, the ModifiableValueMap[1] does not appear at
>> all. Is there some other place for this? I don't think it's OK to have this
>> documentation only on the dev.day.com / CQ website.
>>
>> Cheers,
>> Felix
>>
>> [0]: http://sling.apache.org/apidocs/sling6/index.html
>> [1]:
>> http://dev.day.com/docs/en/cq/current/javadoc/org/apache/sling/api/resource/ModifiableValueMap.html
> The javadoc corresponds to released versions, and Sling 7 is not yet
> out, see [2] . In the meantime, you can use the javadocs published on
> the maven repository with each artifact.
>
> So if you want the /7/ javadoc, feel free to help us with fixing the ITs ;-)
>
> Robert
>
>
> [2]: http://sling.markmail.org/thread/hct2k7ijcnz4pzq7
>
>
> --
> Sent from my (old) computer
Re: Latest JavaDoc?
Posted by Robert Munteanu <ro...@lmn.ro>.
Hi Felix,
> It's bothering me that the latest javadoc[0] on the sling website is not
> really up to date. For example, the ModifiableValueMap[1] does not appear at
> all. Is there some other place for this? I don't think it's OK to have this
> documentation only on the dev.day.com / CQ website.
>
> Cheers,
> Felix
>
> [0]: http://sling.apache.org/apidocs/sling6/index.html
> [1]:
> http://dev.day.com/docs/en/cq/current/javadoc/org/apache/sling/api/resource/ModifiableValueMap.html
The javadoc corresponds to released versions, and Sling 7 is not yet
out, see [2] . In the meantime, you can use the javadocs published on
the maven repository with each artifact.
So if you want the /7/ javadoc, feel free to help us with fixing the ITs ;-)
Robert
[2]: http://sling.markmail.org/thread/hct2k7ijcnz4pzq7
--
Sent from my (old) computer
Re: Latest JavaDoc?
Posted by Bertrand Delacretaz <bd...@apache.org>.
On Tue, May 28, 2013 at 1:59 PM, Felix Meschberger <fm...@adobe.com> wrote:
> ...If we just cut a regular release of launchpad/builder project we get a proper tag. That should IMHO suffice it..
Correct, a clearly named tag would be enough.
-Bertrand
Re: Latest JavaDoc?
Posted by Felix Meschberger <fm...@adobe.com>.
Hi
Am 28.05.2013 um 13:57 schrieb Bertrand Delacretaz:
> On Tue, May 28, 2013 at 1:42 PM, Felix Meschberger <fm...@adobe.com> wrote:
>> ...Maybe we should not generate that complicated source tree but just instead say, that the source release of the Launchpad
>> Builder is just what we have in the repository, which basically is the bundle list...
>
> Yeah, we could do that, and if we also embed the svn revision number
> somewhere in the launchpad that would allow people to go back to the
> exact state that was used to build the launchpad.
Why the revision number ?
If we just cut a regular release of launchpad/builder project we get a proper tag. That should IMHO suffice it
Regards
Felix
Re: Latest JavaDoc?
Posted by Bertrand Delacretaz <bd...@apache.org>.
On Tue, May 28, 2013 at 1:42 PM, Felix Meschberger <fm...@adobe.com> wrote:
> ...Maybe we should not generate that complicated source tree but just instead say, that the source release of the Launchpad
> Builder is just what we have in the repository, which basically is the bundle list...
Yeah, we could do that, and if we also embed the svn revision number
somewhere in the launchpad that would allow people to go back to the
exact state that was used to build the launchpad.
-Bertrand
Re: Latest JavaDoc?
Posted by Felix Meschberger <fm...@adobe.com>.
Hi,
Am 28.05.2013 um 11:27 schrieb Bertrand Delacretaz:
> Hi,
>
> On Tue, May 28, 2013 at 11:18 AM, Felix Oghina <fo...@adobe.com> wrote:
>> ...I think a /current/ URL would be perfect. I wouldn't release the global
>> javadocs monthly if they contain stuff that is not part of the released
>> Sling launchpad, or is that not an issue for some reason?...
>
> What I meant is releasing the Launchpad stuff ("big bang release")
> monthly - we've been quite slow in doing that so far, a faster cycle
> might be useful. But I haven't checked how much work that is ;-)
The problem with release the launchpad is the source release: We currently create a more or less manually built tag for such a release where we svn:external-ize the sources all embedded sling bundles.
I think this is way too much overhead to build such a release, also given the fact, that the main goal of such a release is ease of use ...
Maybe we should not generate that complicated source tree but just instead say, that the source release of the Launchpad Builder is just what we have in the repository, which basically is the bundle list.
WDYT ?
Regards
Felix
Re: Latest JavaDoc?
Posted by Bertrand Delacretaz <bd...@apache.org>.
Hi,
On Tue, May 28, 2013 at 11:18 AM, Felix Oghina <fo...@adobe.com> wrote:
> ...I think a /current/ URL would be perfect. I wouldn't release the global
> javadocs monthly if they contain stuff that is not part of the released
> Sling launchpad, or is that not an issue for some reason?...
What I meant is releasing the Launchpad stuff ("big bang release")
monthly - we've been quite slow in doing that so far, a faster cycle
might be useful. But I haven't checked how much work that is ;-)
I've put the automated /current publishing on my
long-list-of-things-to-do-eventually.
-Bertrand
Re: Latest JavaDoc?
Posted by Felix Oghina <fo...@adobe.com>.
Hi Bertrand,
I think a /current/ URL would be perfect. I wouldn't release the global
javadocs monthly if they contain stuff that is not part of the released
Sling launchpad, or is that not an issue for some reason?
Cheers,
Felix
On 05/28/2013 11:10 AM, Bertrand Delacretaz wrote:
> Hi Felix,
>
> On Tue, May 28, 2013 at 11:00 AM, Felix Oghina <fo...@adobe.com> wrote:
>> ...It's bothering me that the latest javadoc[0] on the sling website is not
>> really up to date...
> Would a http://sling.apache.org/apidocs/current URL that points to
> automatically built trunk javadocs work for you?
>
> As an alternative, we might release our global javadocs more
> regularly, once a month maybe.
>
> -Bertrand
Re: Latest JavaDoc?
Posted by Bertrand Delacretaz <bd...@apache.org>.
Hi Felix,
On Tue, May 28, 2013 at 11:00 AM, Felix Oghina <fo...@adobe.com> wrote:
> ...It's bothering me that the latest javadoc[0] on the sling website is not
> really up to date...
Would a http://sling.apache.org/apidocs/current URL that points to
automatically built trunk javadocs work for you?
As an alternative, we might release our global javadocs more
regularly, once a month maybe.
-Bertrand