Re: Beginner feedback
On Mon, Apr 26, 2010 at 1:58 PM, Alex Objelean wrote: > Hi! > Recently I dedicated a couple of hours to learn about restlet (2.0-RC3). > Maybe it is too little time, but I think my feedback may be important for > restlet improvement. > > I've used as a documentation this link: > http://www.restlet.org/documentation/2.0/firstSteps > It is well documented. Unfortunately, I had some troubles in running the > example. I have downloaded the distribution, created an eclipse project. > The > first problem was to set up the classpath of the project. There a dozen of > dependencies. I didn't know which of them to add to the classpath. This is > where maven would be useful. I use maven for all my projects and find it > very easy to get started with other open source project. All you have to > do, > is to run mvn eclipse:eclipse and maven takes care about all project > dependencies. It would be very useful for restelet adoption to 'mavenize' > the project. Also, it could be useful to have a archetype - to generate a > template of the project ready to run. > > The next problem, was to start the hello world example. I would expect to > add the minimum dependencies to make it work. It seems very strange that > hello world requires more than 10 dependencies to work (even java mail, > grizzly, etc).. It seems a little bit strange, but maybe there is a reason. > I too was a beginner but it required me to have only two dependencies (to run it as a standalone app) org.restlet.jar -> API com.noelios.restlet.jar -> reference impl. > > I like the way restlet is implemented, I would like to understand it better > and use it when I'll have an opportunity. My purpose is not to criticize, > but to help improve restlet. > > Thank you for your work! > Alex > > > -- > View this message in context: > http://restlet-discuss.1400322.n2.nabble.com/Beginner-feedback-tp4961544p4961544.html > Sent from the Restlet Discuss mailing list archive at Nabble.com. > > -- > > http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2595725 > -- http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2601894
Beginner feedback
Hi! Recently I dedicated a couple of hours to learn about restlet (2.0-RC3). Maybe it is too little time, but I think my feedback may be important for restlet improvement. I've used as a documentation this link: http://www.restlet.org/documentation/2.0/firstSteps It is well documented. Unfortunately, I had some troubles in running the example. I have downloaded the distribution, created an eclipse project. The first problem was to set up the classpath of the project. There a dozen of dependencies. I didn't know which of them to add to the classpath. This is where maven would be useful. I use maven for all my projects and find it very easy to get started with other open source project. All you have to do, is to run mvn eclipse:eclipse and maven takes care about all project dependencies. It would be very useful for restelet adoption to 'mavenize' the project. Also, it could be useful to have a archetype - to generate a template of the project ready to run. The next problem, was to start the hello world example. I would expect to add the minimum dependencies to make it work. It seems very strange that hello world requires more than 10 dependencies to work (even java mail, grizzly, etc).. It seems a little bit strange, but maybe there is a reason. I like the way restlet is implemented, I would like to understand it better and use it when I'll have an opportunity. My purpose is not to criticize, but to help improve restlet. Thank you for your work! Alex -- View this message in context: http://restlet-discuss.1400322.n2.nabble.com/Beginner-feedback-tp4961544p4961544.html Sent from the Restlet Discuss mailing list archive at Nabble.com. -- http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2595725
Re: Beginner feedback
Hi Alex, Thanks for taking time to share your experience in such as constructive way. Regarding the dependencies, they are documented in the /lib/readme.txt file, but we probably need to make this more explicit, especially in the first steps page. In Restlet 1.1, we had screencast that we need to upgrade for version 2.0: http://www.restlet.org/documentation/1.1/screencast/ Also, we do support Maven with our own repository, but this could be directly leverage indeed. Regarding the Mavenization/archectypes, we have already got feed-back on this topic: "Add better Maven integration" http://restlet.tigris.org/issues/show_bug.cgi?id=672 "Add Maven archetype" http://restlet.tigris.org/issues/show_bug.cgi?id=412 We have related plans for Restlet 2.1 to improve on this front and bring more productivity for new users and others. Our current focus is on Restlet 2.0 stabilization and "Restlet in Action" book writing: http://www.restlet.org/documentation/books I've entered a RFE to keep track of your feed-back: "Improve first time experience with Restlet" http://restlet.tigris.org/issues/show_bug.cgi?id=1088 Best regards, Jerome Louvel -- Restlet ~ Founder and Technical Lead ~ http://www.restlet.org Noelios Technologies ~ http://www.noelios.com 2010/4/29 Alex Objelean > Hi! > Recently I dedicated a couple of hours to learn about restlet (2.0-RC3). > Maybe it is too little time, but I think my feedback may be important for > restlet improvement. > > I've used as a documentation this link: > http://www.restlet.org/documentation/2.0/firstSteps > It is well documented. Unfortunately, I had some troubles in running the > example. I have downloaded the distribution, created an eclipse project. > The > first problem was to set up the classpath of the project. There a dozen of > dependencies. I didn't know which of them to add to the classpath. This is > where maven would be useful. I use maven for all my projects and find it > very easy to get started with other open source project. All you have to > do, > is to run mvn eclipse:eclipse and maven takes care about all project > dependencies. It would be very useful for restelet adoption to 'mavenize' > the project. Also, it could be useful to have a archetype - to generate a > template of the project ready to run. > > The next problem, was to start the hello world example. I would expect to > add the minimum dependencies to make it work. It seems very strange that > hello world requires more than 10 dependencies to work (even java mail, > grizzly, etc).. It seems a little bit strange, but maybe there is a reason. > > I like the way restlet is implemented, I would like to understand it better > and use it when I'll have an opportunity. My purpose is not to criticize, > but to help improve restlet. > > Thank you for your work! > Alex > -- > View this message in context: > http://restlet-discuss.1400322.n2.nabble.com/Beginner-feedback-tp4979195p4979195.html > Sent from the Restlet Discuss mailing list archive at Nabble.com. > > -- > > http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2598783 > -- http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2600362
Beginner feedback
Hi! Recently I dedicated a couple of hours to learn about restlet (2.0-RC3). Maybe it is too little time, but I think my feedback may be important for restlet improvement. I've used as a documentation this link: http://www.restlet.org/documentation/2.0/firstSteps It is well documented. Unfortunately, I had some troubles in running the example. I have downloaded the distribution, created an eclipse project. The first problem was to set up the classpath of the project. There a dozen of dependencies. I didn't know which of them to add to the classpath. This is where maven would be useful. I use maven for all my projects and find it very easy to get started with other open source project. All you have to do, is to run mvn eclipse:eclipse and maven takes care about all project dependencies. It would be very useful for restelet adoption to 'mavenize' the project. Also, it could be useful to have a archetype - to generate a template of the project ready to run. The next problem, was to start the hello world example. I would expect to add the minimum dependencies to make it work. It seems very strange that hello world requires more than 10 dependencies to work (even java mail, grizzly, etc).. It seems a little bit strange, but maybe there is a reason. I like the way restlet is implemented, I would like to understand it better and use it when I'll have an opportunity. My purpose is not to criticize, but to help improve restlet. Thank you for your work! Alex -- View this message in context: http://restlet-discuss.1400322.n2.nabble.com/Beginner-feedback-tp4979195p4979195.html Sent from the Restlet Discuss mailing list archive at Nabble.com. -- http://restlet.tigris.org/ds/viewMessage.do?dsForumId=4447&dsMessageId=2598783
