[mapserver-users] Improved Documentation

[Jeff McKenna]

David Graham wrote:

> .d.z.a. wrote:
>
> >>> MapServer is not just a success, it is a raving success.
> >>
> >>   I'm new to the Mapserver community. I would agree with this statement
> >> from
> >> a *technical* point of view, but strongly disagree from an
> >> approchability
> >> point of view. There are virtually NO examples of how to create maps, do
> >
> >
> > I wrote the above, and I stand by what I wrote, and yet, I
> > whole-heartedly agree with what you write.
> >
> > I too am frustrated, with my regular web mapping solution, as well as
> > with Mapserver's lack of docs and examples. I waste immense number of
> > hours trying to solve something that has been documented wrong, or not
> > documented at all. Or, the syntax for classes and methods is there, but
> > no real example to wrap my hands around...
> >
>
> I would say that the Mapserver website could realy use the DocNote
> system.  It is a system by which users can add comments to improve
> documentation that is posted on a web page.
>
> Postgres Database uses this method to update it's manual.  It allows
> users to input corrections immediately as they find them and then every
> so often the comments get rolled back into the documentation by an
> editor.  Here is an example:
>
> http://www.postgresql.org/idocs/index.php?start.html

I agree with David...I have often found the user comments in
http://www.php.net/ to be the most helpful part of its documentation.


-------------------
Jeff McKenna
GIS Specialist
DM Solutions Group Inc.
Ottawa, Ontario
http://www.dmsolutions.ca/