A confused Network Admin

[Marco Marsella]

I would like to reassure Christine that she's not the only one confused
about OpenSource in general and MapServer in particular. I have over 25
years of professional programming experience in too many languages,
starting with FORTRAN IV when some of the listers here where probably
not even able to read yet ;-)

I find myself also *very* confused because of the terribly poor
documentation that usually complements OpenSource projects. Most often
than not, there is just a very technical document that tersely explains
what you can do with this or that parameter. With most Java projects
you just find the JavaDoc! There is little or no high-level
documentation that explains the architecture and lets you find your way
around. Most of the projects require that you spend an inordinate
amount of time looking at the code to understand what you can do and
how.

For me, I find the MapServer documentation absolutely insufficient and
it is amazing how people prefer to spend a lot of time replying on this
list rather than investing much more efficiently their time writing
decent documentation and providing good tutorials and examples.

Please, do not misunderstand me! I think MapServer is a terrific
project and I am incredibly grateful to the very knowledgeable guys out
there willing to help through the list. Only, I would much prefer
having good documentation to work through and bother the listers only
when absolutely necessary.

As you may have seen, I put my.. time where the mouth is. As soon as I
learn how to do something, I will post a message to the list hoping
that it might be of help to others (see "[UMN_MAPSERVER-USERS] A
simple... sample!" dated 10 Feb 2005). Sure, it is a trivial example,
but it took me *a lot* of time (and a zillion Google searches) to
figure out, much longer than I would expect! I will be more than happy
to continue doing so to alleviate the trouble of learning MapServer!

Cheers

Marco