[mapserver-dev] Versioned MapServer Docs?

[Brent Fraser]

Bob,

Here's a snip of what I've got so far (see attached).

- It's laid out to copy-and paste to a text file for for tweaking
- I like the syntax highlighting of .rst (thanks Jeff?) (not possible with markdown)
- I plan to add links to doc at the keywords (possible with markdown, not with .rst?)

Brent

----------------------------------------

From: "Basques, Bob (CI-StPaul)" <bob.basques at ci.stpaul.mn.us>
Sent: 3/19/21 9:47 AM
To: "bfraser at geoanalytic.com" <bfraser at geoanalytic.com>, "Rahkonen Jukka (MML)" <jukka.rahkonen at maanmittauslaitos.fi>, Seth G <sethg at geographika.co.uk>, "mapserver-dev at lists.osgeo.org" <mapserver-dev at lists.osgeo.org>
Subject: Re: [mapserver-dev] Versioned MapServer Docs?

Brent,

I had thought about something similar to your last thought.  Basically a Diagram Doc page of a Sample Mapfile.  Something showing most if not all options where possible.

I've been hitting the MapFile Comments side of things lately as well, as in maybe too many comments, etc.  But I need to start thinking about how to pass on the system to others in the future, so . . .

Bobb

From: Brent Fraser <bfraser at geoanalytic.com>
Reply-To: Brent Fraser <bfraser at geoanalytic.com>
Date: Friday, March 19, 2021 at 10:21 AM
To: Bob Basques <bob.basques at ci.stpaul.mn.us>, "Rahkonen Jukka (MML)" <jukka.rahkonen at maanmittauslaitos.fi>, Seth G <sethg at geographika.co.uk>, "mapserver-dev at lists.osgeo.org" <mapserver-dev at lists.osgeo.org>
Subject: Re: [mapserver-dev] Versioned MapServer Docs?

Think Before You Click: This email originated outside our organization.	

Hi Bob,

While we're blue-skying, here are a couple of related ideas I've been toying with:

Mapfile generator:  a python command line to take a path to a shapefile and produce a mapfile to render it (from a mapfile template for a specific version of mapserver)

Mapfile cheatsheat: a web page showing a simple mapfile suitable for saving and tweaking.  Bonus: with lots of comments

and links to the mapserver doc to aid in tweaking.

Best Regards,

Brent Fraser

----------------------------------------

From: "Basques, Bob (CI-StPaul)" <bob.basques at ci.stpaul.mn.us>
Sent: 3/19/21 7:19 AM
To: "Rahkonen Jukka (MML)" <jukka.rahkonen at maanmittauslaitos.fi>, Seth G <sethg at geographika.co.uk>, "mapserver-dev at lists.osgeo.org" <mapserver-dev at lists.osgeo.org>
Subject: Re: [mapserver-dev] Versioned MapServer Docs?

Hmm,  probably not contributing in the spirit here (reducing effort . . .) but has anyone ever thought about a MapFile parser service, would be cool to have something that told the user what versions of Mapserver their MapFile would work for as well as finding problems related to old/deprecated features.  Hmm, even linking to the docs where appropriate . . .  New features and test parsing would be a slick add.  Test you install before updating?  Would promote upgrading too I think over the long run.  I know I have some work to do on this front with my own installs.

Bobb

 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20210319/42d6686f/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: cs_cheatsheet_snip.png
Type: image/png
Size: 37680 bytes
Desc: not available
URL: <http://lists.osgeo.org/pipermail/mapserver-dev/attachments/20210319/42d6686f/attachment-0001.png>