[Geoserver-devel] Maven not so quick start

Hi Everyone;

First of all it seems my testing of geoserver trunk has not faired well - I was testing the WFS Demo with MapBuilder - a recent improved mapbuilder actually includes background data so I did not notice geoserver WMS was broken :frowning:

The error messages I reported on the list were literally about geoserver having no configuration.

Which brings me up to the next point:
- http://docs.codehaus.org/display/GEOSDOC/2+Maven+Quickstart

This page is not a general maven reference (no javadocs, no alternatives, no nothing). It is a quick start to get something on screen starting from source code.

It appears we need to provide instructions for checking out the default configuration as part of this page (now that the minimal configuration is actually an empty configuration).

Q: Is it really worth making the default configuration empty? We could just include states.shp and be done with it? Letting developers check out and get visual confirmation is what we are after and putting off talking about configuration until later would be worth it.

Jody

I shuffled most of the the reference information off to this page:
- http://docs.codehaus.org/display/GEOSDOC/Maven+Build+Reference

I updated the examples to be a "Story" again. Being sure to include the mkdir and cd instructions needed so people can cut and paste. My preference would to be have these expressed in terms of a windows users :slight_smile:

The instructions have been checked against my work machine - since this has had a complete checkout of geoserver previously it is not a fair test.

If anyone has a untouched windows machine it would be good to confirm the error messages are still the same. The current page mentions failing due to lack of a configuration - but I thought we included an empty one now?

Cheers,
Jody

Hi Everyone;

First of all it seems my testing of geoserver trunk has not faired well - I was testing the WFS Demo with MapBuilder - a recent improved mapbuilder actually includes background data so I did not notice geoserver WMS was broken :frowning:

The error messages I reported on the list were literally about geoserver having no configuration.

Which brings me up to the next point:
- http://docs.codehaus.org/display/GEOSDOC/2+Maven+Quickstart

This page is not a general maven reference (no javadocs, no alternatives, no nothing). It is a quick start to get something on screen starting from source code.

It appears we need to provide instructions for checking out the default configuration as part of this page (now that the minimal configuration is actually an empty configuration).

Q: Is it really worth making the default configuration empty? We could just include states.shp and be done with it? Letting developers check out and get visual confirmation is what we are after and putting off talking about configuration until later would be worth it.

Jody

-------------------------------------------------------------------------
This SF.net email is sponsored by DB2 Express
Download DB2 Express C - the FREE version of DB2 express and take
control of your XML. No limits. Just data. Click to get it now.
http://sourceforge.net/powerbar/db2/
_______________________________________________
Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel
  

Jody Garnett ha scritto:

Hi Everyone;

First of all it seems my testing of geoserver trunk has not faired well - I was testing the WFS Demo with MapBuilder - a recent improved mapbuilder actually includes background data so I did not notice geoserver WMS was broken :frowning:

The error messages I reported on the list were literally about geoserver having no configuration.

Can you refresh my memory? This kind of error should not happen.

Which brings me up to the next point:
- http://docs.codehaus.org/display/GEOSDOC/2+Maven+Quickstart

This page is not a general maven reference (no javadocs, no alternatives, no nothing). It is a quick start to get something on screen starting from source code.

Hum, this is unfair. It's a reasonable quickstart looking at Geoserver
as an application. But you're right, if we want to make Geoserver a
framework, in the long run, we'll need to treat it as such and so
include directions to build javadocs and the like.
Yet, until modularization is completed (UI is missing), and the new
dispatcher is deployed onto all services, and the catalog is replaced,
touting Geoserver as a framework is giving false hopes to the reader.

It appears we need to provide instructions for checking out the default configuration as part of this page (now that the minimal configuration is actually an empty configuration).

Well... the default config is long gone. If you're messing with Geoserver and have few bandwith, use the emtpy configuration and add your local data to preview something. If you have enough bandwith, check out the full stuff (not trunk/geoserver, but trunk/) and play with
release data. The default config just added mantainance and size
overhead to the configuration set.

Q: Is it really worth making the default configuration empty? We could just include states.shp and be done with it? Letting developers check out and get visual confirmation is what we are after and putting off talking about configuration until later would be worth it.

I disagree. The emtpy configuration is your starter point for
developing a new geoserver based application, and contains just
enough information to get Geoserver started and fiddle with your
local data. If you're checking out Geoserver sources you're also supposed to be able and use it, so adding a local shapefile should be
a matter of a couple of minutes.

Cheers
Andrea

Jody Garnett ha scritto:

I shuffled most of the the reference information off to this page:
- http://docs.codehaus.org/display/GEOSDOC/Maven+Build+Reference

Cool, thank you.

I updated the examples to be a "Story" again. Being sure to include the mkdir and cd instructions needed so people can cut and paste. My preference would to be have these expressed in terms of a windows users :slight_smile:

I'd say, whoever writes them is better use the environment he's on
as a reference and test.
Better write correct unix commands than a broken windows translation.

The instructions have been checked against my work machine - since this has had a complete checkout of geoserver previously it is not a fair test.

If anyone has a untouched windows machine it would be good to confirm the error messages are still the same. The current page mentions failing due to lack of a configuration - but I thought we included an empty one now?

Jody, look around, besides the pages that are actually used by developers (cite and similar) the rest is updated only when a user
complains or we notice something is wrong.
Anyways, that error should no happen anymore, I agree.
It's just that I cannot test it to make sure, since I don't have a clean machine, me neither.

Cheers
Andrea

Andrea Aime wrote:

The error messages I reported on the list were literally about geoserver having no configuration.

Can you refresh my memory? This kind of error should not happen.

It is on that page still as an example of what to expect - something in the web module would fail when it did not have a configuraiton.

I found that my home machine does not have a geoserver development environment on it so I will be able to check this one over the next couple of days.

Hum, this is unfair. It's a reasonable quickstart looking at Geoserver
as an application. But you're right, if we want to make Geoserver a
framework, in the long run, we'll need to treat it as such and so
include directions to build javadocs and the like.

I am setting up some new developers for geoserver life and happiness and at this stage in the experience I wanted instructions to point them towards (not explainations and alternatives). Since I have the need I am updating the page before hand.

Yet, until modularization is completed (UI is missing), and the new
dispatcher is deployed onto all services, and the catalog is replaced,
touting Geoserver as a framework is giving false hopes to the reader.

Indeed. My focus is literally on starting off new geoserver developers. I would like more of them it is true; and we have this whimsical notion that documentation will help with that. Paul Ramsey has a blog on the topic somewhere ...

It appears we need to provide instructions for checking out the default configuration as part of this page (now that the minimal configuration is actually an empty configuration).

Well... the default config is long gone. If you're messing with Geoserver and have few bandwith, use the emtpy configuration and add your local data to preview something. If you have enough bandwith, check out the full stuff (not trunk/geoserver, but trunk/) and play with release data. The default config just added mantainance and size
overhead to the configuration set.

Understood; and this page was the one I figured was most effected by the configuration stuff. The new instructions did not say how to check out a configuration from svn - I have added it in now. I did use release as an example but it sounds like that contains too mcuh stuff?

Is there a small configuration that would be better to choose - give my goal of setting up someone quickly.

Q: Is it really worth making the default configuration empty? We could just include states.shp and be done with it? Letting developers check out and get visual confirmation is what we are after and putting off talking about configuration until later would be worth it.

I disagree. The emtpy configuration is your starter point for
developing a new geoserver based application, and contains just
enough information to get Geoserver started and fiddle with your
local data. If you're checking out Geoserver sources you're also
supposed to be able and use it, so adding a local shapefile should be
a matter of a couple of minutes.

Okay; so it is worth it making the default configuration empty then.

Jody

Jody Garnett ha scritto:

Andrea Aime wrote:

Understood; and this page was the one I figured was most effected by the configuration stuff. The new instructions did not say how to check out a configuration from svn - I have added it in now. I did use release as an example but it sounds like that contains too mcuh stuff?

Well, if you're setting up for serious development you better check out
from trunk/ directly (that is, have cite too).
Release doesn't have too much stuff, it has the bare minimum stuff needed to show the various Geoserver capabilities imho.

Is there a small configuration that would be better to choose - give my goal of setting up someone quickly.

A small configuration would be useful for someone doing x, and useless
for someone doing y. It all depends on what services you're playing against. WFS, WCS, WMS, WFS-T...

Q: Is it really worth making the default configuration empty? We could just include states.shp and be done with it? Letting developers check out and get visual confirmation is what we are after and putting off talking about configuration until later would be worth it.

I disagree. The emtpy configuration is your starter point for
developing a new geoserver based application, and contains just
enough information to get Geoserver started and fiddle with your
local data. If you're checking out Geoserver sources you're also
supposed to be able and use it, so adding a local shapefile should be
a matter of a couple of minutes.

Okay; so it is worth it making the default configuration empty then.

A configuration in between empty and release is basically useless
for some usage or another. Besides that, I would like to avoid yet another configuration to maintain... can you make it for the Geoserver
meeting tonight?

Cheers
Andrea