Been looking at your add-on. It is very hard to evaluate without Javadoc. There's no Javadoc in Vaadin's Maven Repo for your add-on, unlike most other add-ons.
I'm not an expert of Vaadin add-ons but perhaps the reason is that you've uploaded the jar file rather than the zip file to vaadin.com ?
Also: Your links to Jelastic site are broken.
Thanks.
Peter
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I have repaired the javadoc link on the Vaadin addon page. Yesterday, I have moved all resources from the hoster servint to openshift, because servint ran out of resource all the time. Unfortunally, openshift seems to have some issues. Today, I have checked my deployed wars on the server and all were undeployed. I have redeployed all. But it seems so, that I have to take a look on the reliability of the server the next days.
The publishing of an addon over the vaadin page is a tricky thing. You cannot upload your plugin to the maven repos directly. You only can add a single jar. Zips are not allowed. The jar must also have some specific metadata to be accepted. I have decided not to blow up the addon.jar with the javadoc, because I want to keep the jar as small as possible. Unfortunally, I have no idea for an alternative solution.
May you tell me one or more addons where the javadoc is available? I will to investigate how these authors has publish there javadoc.
BTW, it would be kind of you, if you change your rating. I even help if I get good ratings!
Regards,
Dieter
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Absolutely I'll change the rating. Sorry, I was frustrated and it was unfair. For the moment I've removed the rating.
Your "competitor", ConfirmDialog, has sources and javadocs in the Vaadin Maven repo. I cannot see that Vaadin's Maven Repo allows browsing but you can just construct the URL yourself to check what's available in the repo:
This hint is interesting. I ask me, how he has done it, because it isn't possible over the web gui. I will check it at the evening, if I may deploy directly to there repository from maven. Anyway, I will search for a solution.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I cannot publish directly to their repos, but I can publish the addon with source and javadoc inside a zip. The zip must have a special format. Other addon authors have also problems creating such a zip (Link 1 and Link 2). I have started a manual test. Currently, I wait for the scheduler publishing the archives to their repos. I hope, I can successfully test the upload in a few hours.
BTW, it seems so, that I have deployed the demo and javadoc at the right place on openshift. Tomorrow, I will switch from servint to openshift.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Come to think of it: Why don't you move your project to Github? They give you Javadoc hosting for free. As a coincidence the Vaadin people actually wrote about this topic: https://vaadin.com/blog/-/blogs/host-your-javadoc-s-online-in-github. I realize it means you'll have to learn DVCS but maybe you do already. In any case I think you'll have to take the jump sooner or later.
However, having Javadoc in the Maven Repo is more important than hosting it somewhere online, IMHO. The two solutions complement each other. Users of your add-on will be developers, and developers use IDEs and IDEs tend to attempt to get the javadoc from whatever Mavep Repo is configured for their project. The downside to Javadoc in Maven Repo is that IDEs rarely allows you to use the Javadoc before you've actually added the project as a dependency in your POM.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
FYI, I have open a discussion at the vaadin forum, because I have problems publishing a new version with source and javadoc. Maybe you want to follow the discussion. Here is the link.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I would expect that if you generate the ZIP from the POM which in turn was generated from Vaadin Maven Archetype for Add-On then then ZIP will be in the correct format and the upload will succeed. Haven't tried it myself though. So my recommendation would be not to attempt to the create the ZIP, nor the inside contents, yourself.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
I got it, finally! The version 3.0.12 is created manually, but with javadoc and sources. Tomorrow, I will update the poms to create the zip automatically. Unbelievable, how squeamishly the deployment is. Anyway, I tried the archetype some time ago. I hadn't got it run. Maybe, it work now or I have more knowledge to make it run now, but I won't invest more time for it. I will modify my poms a little bit and deploy it. I think, it is the cheaper way.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Hi Dieter
Been looking at your add-on. It is very hard to evaluate without Javadoc. There's no Javadoc in Vaadin's Maven Repo for your add-on, unlike most other add-ons.
I'm not an expert of Vaadin add-ons but perhaps the reason is that you've uploaded the jar file rather than the zip file to vaadin.com ?
Also: Your links to Jelastic site are broken.
Thanks.
Peter
Hello Peter
I have repaired the javadoc link on the Vaadin addon page. Yesterday, I have moved all resources from the hoster servint to openshift, because servint ran out of resource all the time. Unfortunally, openshift seems to have some issues. Today, I have checked my deployed wars on the server and all were undeployed. I have redeployed all. But it seems so, that I have to take a look on the reliability of the server the next days.
The publishing of an addon over the vaadin page is a tricky thing. You cannot upload your plugin to the maven repos directly. You only can add a single jar. Zips are not allowed. The jar must also have some specific metadata to be accepted. I have decided not to blow up the addon.jar with the javadoc, because I want to keep the jar as small as possible. Unfortunally, I have no idea for an alternative solution.
May you tell me one or more addons where the javadoc is available? I will to investigate how these authors has publish there javadoc.
BTW, it would be kind of you, if you change your rating. I even help if I get good ratings!
Regards,
Dieter
Absolutely I'll change the rating. Sorry, I was frustrated and it was unfair. For the moment I've removed the rating.
Your "competitor", ConfirmDialog, has sources and javadocs in the Vaadin Maven repo. I cannot see that Vaadin's Maven Repo allows browsing but you can just construct the URL yourself to check what's available in the repo:
Compare that with MessageBox Add-On. I hope you can use that to figure out how the author of ConfirmDialog has been able to publish Javadoc.
This hint is interesting. I ask me, how he has done it, because it isn't possible over the web gui. I will check it at the evening, if I may deploy directly to there repository from maven. Anyway, I will search for a solution.
I cannot publish directly to their repos, but I can publish the addon with source and javadoc inside a zip. The zip must have a special format. Other addon authors have also problems creating such a zip (Link 1 and Link 2). I have started a manual test. Currently, I wait for the scheduler publishing the archives to their repos. I hope, I can successfully test the upload in a few hours.
BTW, it seems so, that I have deployed the demo and javadoc at the right place on openshift. Tomorrow, I will switch from servint to openshift.
Come to think of it: Why don't you move your project to Github? They give you Javadoc hosting for free. As a coincidence the Vaadin people actually wrote about this topic: https://vaadin.com/blog/-/blogs/host-your-javadoc-s-online-in-github. I realize it means you'll have to learn DVCS but maybe you do already. In any case I think you'll have to take the jump sooner or later.
However, having Javadoc in the Maven Repo is more important than hosting it somewhere online, IMHO. The two solutions complement each other. Users of your add-on will be developers, and developers use IDEs and IDEs tend to attempt to get the javadoc from whatever Mavep Repo is configured for their project. The downside to Javadoc in Maven Repo is that IDEs rarely allows you to use the Javadoc before you've actually added the project as a dependency in your POM.
FYI, I have open a discussion at the vaadin forum, because I have problems publishing a new version with source and javadoc. Maybe you want to follow the discussion. Here is the link.
I would expect that if you generate the ZIP from the POM which in turn was generated from Vaadin Maven Archetype for Add-On then then ZIP will be in the correct format and the upload will succeed. Haven't tried it myself though. So my recommendation would be not to attempt to the create the ZIP, nor the inside contents, yourself.
I got it, finally! The version 3.0.12 is created manually, but with javadoc and sources. Tomorrow, I will update the poms to create the zip automatically. Unbelievable, how squeamishly the deployment is. Anyway, I tried the archetype some time ago. I hadn't got it run. Maybe, it work now or I have more knowledge to make it run now, but I won't invest more time for it. I will modify my poms a little bit and deploy it. I think, it is the cheaper way.