tliron / prudence

An opinionated lightweight web framework built for scale
https://prudence.threecrickets.com
Apache License 2.0
13 stars 5 forks source link

Better download page #5

Closed GoogleCodeExporter closed 9 years ago

GoogleCodeExporter commented 9 years ago
Users complain that the download page is too confusing:

1. They are bewildered with choices. Perhaps we should just recommend the 
Kitchen Sink flavor Perhaps it should be renamed to "Standard Flavor"?

2. It seems that at least one user has missed the fact that we have an Ubuntu 
repository! This should be made more prominent.

Original issue reported on code.google.com by tal.liron on 21 Aug 2011 at 2:56

GoogleCodeExporter commented 9 years ago
I've organized it better, I hope:

1. The JavaScript flavor is now recommended for newcomers. (The Kitchen Sink 
flavor is currently unsuitable for newcomers due to its requirement for 
Quercus.)

2. The Ubuntu repository is now mentioned right at the top!

Furthermore, the wording on how to get rolling has been changed for better 
clarity.

Original comment by tal.liron on 21 Aug 2011 at 8:20

GoogleCodeExporter commented 9 years ago
I am leaving this open for now to allow for further comments and suggestions.

Original comment by tal.liron on 21 Aug 2011 at 9:55

GoogleCodeExporter commented 9 years ago
As a newcomer the Javascript choice was not the best, because of lacking tool 
support. It's really hart to start with something quickly, if there is 
virtually no good tooling (missing code folding, etc...). Especially the mix 
between Javascript and Rhino.

I wanted to use Groovy first and failed to install the Groovy plugin in Eclipse 
3.7. As I wanted to start with Prudence quickly I've changed to Javascript, as 
I have more experience with this.

The hardest thing for me to start was not the flavor, but
* the documentation at all. The documentation is well written, but it's hart to 
find things when I need them. There really should be more simple examples, 
which only explain one thing, i.e. How to use the cache? How to write a 
resource? 
** Till now I didn't found out how filters work
** Using Javascript should tell everyone to have a look at Rhino on Javascript 
specific problems
* Also not bad would be an example for an IDE setup, I for myself used
** Eclipse 3.7 JEE
** created a Maven project and
** Symlinked the target folder into Prudences application folder
** (Feature wish: Prudence server wrapper for Eclipse, Maven archetype for 
Prudence project)

Nevertheless I like Prudence, it looks well thought out and it's quite easy to 
getting started. For me the current main pitfall is not any flavor, it's the 
documentation and tool support. For instance, for my little project I've wrote 
some more complex parts in Java. I was way faster than in Javascript, because 
of Eclipses awesome Java support.

Original comment by Datensch...@gmail.com on 29 Aug 2011 at 6:20

GoogleCodeExporter commented 9 years ago
Thanks! There are some issues here that go beyond the issue (download page :) 
), but I will open new ones:

* There are so many good JavaScript editors out there, definitely very widely 
supported in my opinion! Even Eclipse has excellent JavaScript support. You 
need to add it via Help->Install New Software. Also, Aptana Studio (based on 
Eclipse) has very nice JavaScript support.

* The tutorial includes a section on how to write a resource. How can it be 
made better?

* New issue #20 for Maven archetype

* New issue #21 to add a detailed example on how to create a filter

* New issue #22 to add more examples for using the cache backend

Original comment by tal.liron on 29 Aug 2011 at 6:36

GoogleCodeExporter commented 9 years ago
Tal, thanks,

okay the resource example wasn't the best, this is really good written. 

I'm using Eclipse with Javascript support, but it lacks support for useful code 
completion/code folding, as it doesn't know about available libraries. For 
instance, from where should it know that it virtually can use any Java class or 
what Rhino supports? Maybe it is possible to configure it somewhere, I will 
have a look into this.

Original comment by Datensch...@gmail.com on 30 Aug 2011 at 6:25

GoogleCodeExporter commented 9 years ago
Almost every issue touched by this bug report is being revised for Prudence 2.0.

Original comment by tal.liron on 14 Jan 2012 at 10:16