You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jackrabbit.apache.org by "Celina Konito (JIRA)" <ji...@apache.org> on 2006/01/04 16:23:00 UTC

[jira] Created: (JCR-296) More details for beginners

More details for beginners
--------------------------

         Key: JCR-296
         URL: http://issues.apache.org/jira/browse/JCR-296
     Project: Jackrabbit
        Type: Wish
    Reporter: Celina Konito


Hi everyone,

I'm one of these beginners trying to make their way in Jackrabbit and content repositories universe.

Besides the fact that there exist but very few examples on Jackrabbit use, all of them, including the official web site of Jackrabbit miss few details, simple though essential, for beginners.

My first point is the following: once Jackrabbit source is checked out and built, time to test it using simple examples. But, where to put the example directory from the beginning. How to run it (maven java:compile....) ?

A second point is the fact that there is no help forum on the Jackrabbit web site.

 A third point, taking my case as an example, the example would just not create a new workspace configuration.
And many other troubleshoots - I repeat - basic but essential, that could avoid dozens of wasted hours and discouragment, if just mentioned on the website.

Here it is my wish :-) for the best of Jackrabbit ;-) I hope!
Regards,
Celina

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Assigned: (JCR-296) More details for beginners

Posted by "Jukka Zitting (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/JCR-296?page=all ]

Jukka Zitting reassigned JCR-296:
---------------------------------

    Assign To: Jukka Zitting

> More details for beginners
> --------------------------
>
>          Key: JCR-296
>          URL: http://issues.apache.org/jira/browse/JCR-296
>      Project: Jackrabbit
>         Type: Wish
>     Reporter: Celina Konito
>     Assignee: Jukka Zitting

>
> Hi everyone,
> I'm one of these beginners trying to make their way in Jackrabbit and content repositories universe.
> Besides the fact that there exist but very few examples on Jackrabbit use, all of them, including the official web site of Jackrabbit miss few details, simple though essential, for beginners.
> My first point is the following: once Jackrabbit source is checked out and built, time to test it using simple examples. But, where to put the example directory from the beginning. How to run it (maven java:compile....) ?
> A second point is the fact that there is no help forum on the Jackrabbit web site.
>  A third point, taking my case as an example, the example would just not create a new workspace configuration.
> And many other troubleshoots - I repeat - basic but essential, that could avoid dozens of wasted hours and discouragment, if just mentioned on the website.
> Here it is my wish :-) for the best of Jackrabbit ;-) I hope!
> Regards,
> Celina

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Updated: (JCR-296) More details for beginners

Posted by "Jukka Zitting (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/JCR-296?page=all ]

Jukka Zitting updated JCR-296:
------------------------------

      Component: docs
    Fix Version: 1.0

> More details for beginners
> --------------------------
>
>          Key: JCR-296
>          URL: http://issues.apache.org/jira/browse/JCR-296
>      Project: Jackrabbit
>         Type: Wish
>   Components: docs
>     Reporter: Celina Konito
>     Assignee: Jukka Zitting
>      Fix For: 1.0

>
> Hi everyone,
> I'm one of these beginners trying to make their way in Jackrabbit and content repositories universe.
> Besides the fact that there exist but very few examples on Jackrabbit use, all of them, including the official web site of Jackrabbit miss few details, simple though essential, for beginners.
> My first point is the following: once Jackrabbit source is checked out and built, time to test it using simple examples. But, where to put the example directory from the beginning. How to run it (maven java:compile....) ?
> A second point is the fact that there is no help forum on the Jackrabbit web site.
>  A third point, taking my case as an example, the example would just not create a new workspace configuration.
> And many other troubleshoots - I repeat - basic but essential, that could avoid dozens of wasted hours and discouragment, if just mentioned on the website.
> Here it is my wish :-) for the best of Jackrabbit ;-) I hope!
> Regards,
> Celina

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


Re: A beginner question

Posted by Jukka Zitting <ju...@gmail.com>.
Hi,

On 1/5/06, sirène vip <si...@hotmail.com> wrote:
> 1. I cannot find "jackrabbit-commons-1.0-dev.jar",
> "jackrabbit-api-1.0-dev.jar" and "jackrabbit-core-1.0-dev.jar" in target/lib
> as mentioned in First Hops example.

The example is unfortunately out of date, the Jackrabbit build system
underwent a few changes during last summer and nobody noticed to
update the First Hops page to reflect that. Thanks for pointing the
problem out!

> However, I have in $HOME_Directory\.maven\repository,
> jackrabbit-commons-1.0-SNAPSHOT and jackrabbit-1.0-SNAPSHOT thanks to maven
> jar:install.

The jackrabbit-1.0-SNAPSHOT.jar is the one you need. The
jackrabbit-commons jar contains a subset of the classes in the main
jackrabbit jar and is used as a source of common functionality for
other JCR applications.

> 2. I included in a lib folder all the dependencies required for Jackrabbit
> as well as the above jars. Still it cannot find the pakage
> org.apache.jackrabbit.core.jndi.

The o.a.j.core.jndi package should be included in the
jackrabbit-1.0-SNAPSHOT.jar. Are you sure your classpath includes the
correct jar files?

BR,

Jukka Zitting

--
Yukatan - http://yukatan.fi/ - info@yukatan.fi
Software craftmanship, JCR consulting, and Java development

RE: [jira] Commented: (JCR-296) More details for beginners

Posted by sir�ne vip <si...@hotmail.com>.

>Thanks for raising the issue! You are absolutely correct, the available 
>documentation is not very >beginner-friendly. I'll take a look at the 
>issues you raised.
Thank you!

>About having a help forum on the web site: We are currently using on the 
>jackrabbit-dev mailing list as the forum for asking questions as well as 
>discussing Jackrabbit issues. Would there be interest in for example 
>setting up a part of the Jackrabbit wiki as an easier-to-approach Q/A forum 
>for new users?
>
I just think it  would be a good idea.

Beginner's questions are always lost in more advanced questions and are 
considered as of minor priority. Although, sometimes (if not always)  when 
resolving these minor problem, we can finally make the most progress....

Regards,
Celina

> > More details for beginners
> > --------------------------
> >
> >          Key: JCR-296
> >          URL: http://issues.apache.org/jira/browse/JCR-296
> >      Project: Jackrabbit
> >         Type: Wish
> >     Reporter: Celina Konito
> >     Assignee: Jukka Zitting
>
> >
> > Hi everyone,
> > I'm one of these beginners trying to make their way in Jackrabbit and 
>content repositories universe.
> > Besides the fact that there exist but very few examples on Jackrabbit 
>use, all of them, including the official web site of Jackrabbit miss few 
>details, simple though essential, for beginners.
> > My first point is the following: once Jackrabbit source is checked out 
>and built, time to test it using simple examples. But, where to put the 
>example directory from the beginning. How to run it (maven 
>java:compile....) ?
> > A second point is the fact that there is no help forum on the Jackrabbit 
>web site.
> >  A third point, taking my case as an example, the example would just not 
>create a new workspace configuration.
> > And many other troubleshoots - I repeat - basic but essential, that 
>could avoid dozens of wasted hours and discouragment, if just mentioned on 
>the website.

_________________________________________________________________
FREE pop-up blocking with the new MSN Toolbar - get it now! 
http://toolbar.msn.click-url.com/go/onm00200415ave/direct/01/


A beginner question

Posted by sir�ne vip <si...@hotmail.com>.


Hello....again,

I'm using JBuilder as a development environment.

I have the following problems:
1. I cannot find "jackrabbit-commons-1.0-dev.jar", 
"jackrabbit-api-1.0-dev.jar" and "jackrabbit-core-1.0-dev.jar" in target/lib 
as mentioned in First Hops example.

However, I have in $HOME_Directory\.maven\repository, 
jackrabbit-commons-1.0-SNAPSHOT and jackrabbit-1.0-SNAPSHOT thanks to maven 
jar:install.

2. I included in a lib folder all the dependencies required for Jackrabbit 
as well as the above jars. Still it cannot find the pakage 
org.apache.jackrabbit.core.jndi.

Any help would be appreciated. Thank you.
Regards.

_________________________________________________________________
Express yourself instantly with MSN Messenger! Download today it's FREE! 
http://messenger.msn.click-url.com/go/onm00200471ave/direct/01/


[jira] Commented: (JCR-296) More details for beginners

Posted by "Jukka Zitting (JIRA)" <ji...@apache.org>.
    [ http://issues.apache.org/jira/browse/JCR-296?page=comments#action_12361821 ] 

Jukka Zitting commented on JCR-296:
-----------------------------------

Thanks for raising the issue! You are absolutely correct, the available documentation is not very beginner-friendly. I'll take a look at the issues you raised.

About having a help forum on the web site: We are currently using on the jackrabbit-dev mailing list as the forum for asking questions as well as discussing Jackrabbit issues. Would there be interest in for example setting up a part of the Jackrabbit wiki as an easier-to-approach Q/A forum for new users?


> More details for beginners
> --------------------------
>
>          Key: JCR-296
>          URL: http://issues.apache.org/jira/browse/JCR-296
>      Project: Jackrabbit
>         Type: Wish
>     Reporter: Celina Konito
>     Assignee: Jukka Zitting

>
> Hi everyone,
> I'm one of these beginners trying to make their way in Jackrabbit and content repositories universe.
> Besides the fact that there exist but very few examples on Jackrabbit use, all of them, including the official web site of Jackrabbit miss few details, simple though essential, for beginners.
> My first point is the following: once Jackrabbit source is checked out and built, time to test it using simple examples. But, where to put the example directory from the beginning. How to run it (maven java:compile....) ?
> A second point is the fact that there is no help forum on the Jackrabbit web site.
>  A third point, taking my case as an example, the example would just not create a new workspace configuration.
> And many other troubleshoots - I repeat - basic but essential, that could avoid dozens of wasted hours and discouragment, if just mentioned on the website.
> Here it is my wish :-) for the best of Jackrabbit ;-) I hope!
> Regards,
> Celina

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira


[jira] Resolved: (JCR-296) More details for beginners

Posted by "Jukka Zitting (JIRA)" <ji...@apache.org>.
     [ http://issues.apache.org/jira/browse/JCR-296?page=all ]
     
Jukka Zitting resolved JCR-296:
-------------------------------

    Resolution: Fixed

Made the following improvements:

- Updated and clarified the First Hops document
- Created a questions and answers page on the Jackrabbit wiki
- Improved the "Getting Started" section of the Jackrabbit documentation page

It's not much, but hopefully better than nothing. :-)

PS. If you (or anyone else) have ideas of good examples to be included on the Jackrabbit web site, please file a Jira issue for those!


> More details for beginners
> --------------------------
>
>          Key: JCR-296
>          URL: http://issues.apache.org/jira/browse/JCR-296
>      Project: Jackrabbit
>         Type: Wish
>   Components: docs
>     Reporter: Celina Konito
>     Assignee: Jukka Zitting
>      Fix For: 1.0

>
> Hi everyone,
> I'm one of these beginners trying to make their way in Jackrabbit and content repositories universe.
> Besides the fact that there exist but very few examples on Jackrabbit use, all of them, including the official web site of Jackrabbit miss few details, simple though essential, for beginners.
> My first point is the following: once Jackrabbit source is checked out and built, time to test it using simple examples. But, where to put the example directory from the beginning. How to run it (maven java:compile....) ?
> A second point is the fact that there is no help forum on the Jackrabbit web site.
>  A third point, taking my case as an example, the example would just not create a new workspace configuration.
> And many other troubleshoots - I repeat - basic but essential, that could avoid dozens of wasted hours and discouragment, if just mentioned on the website.
> Here it is my wish :-) for the best of Jackrabbit ;-) I hope!
> Regards,
> Celina

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
   http://www.atlassian.com/software/jira