The migration guide serves as depricated/changed/new documentation. -Steve<br><br><div class="gmail_quote">On Fri, Jul 22, 2011 at 8:22 AM, Mark Volz <span dir="ltr"><<a href="mailto:MarkVolz@co.lyon.mn.us">MarkVolz@co.lyon.mn.us</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin: 0pt 0pt 0pt 0.8ex; border-left: 1px solid rgb(204, 204, 204); padding-left: 1ex;">
<div>
<font face="Calibri" size="2"><span style="font-size: 11pt;">
<div>Steve,</div>
<div> </div>
<div>As a user of Mapserver here are some of my comments about the documentation:</div>
<div> </div>
<ul style="margin: 0pt; padding-left: 38.25pt;">
<li>I don’t think that multiple versions of documentation need to be maintained in HTML format. Old versions can be documented in a searchable PDF format, or perhaps an ePub document on the website. I think that would be easy to maintain, and it would be
easy for users if the older documentation is easy to find on the website.</li><li>Statements such as “Depreciated in 6.0”, “Changed in 6.0”, and “New in 6.0” help indicate to users that we might need to reference the older documentation.</li>
</ul>
<div> </div>
<div> </div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Message: 1</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Date: Thu, 21 Jul 2011 11:42:01 -0500</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">From: Steve Lime <<a href="mailto:sdlime@gmail.com" target="_blank"><font color="blue"><u>sdlime@gmail.com</u></font></a>></span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Subject: [mapserver-dev] Documentation Question</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">To: <a href="mailto:mapserver-dev@lists.osgeo.org" target="_blank"><font color="blue"><u>mapserver-dev@lists.osgeo.org</u></font></a></span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Message-ID:</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;"> <<a href="mailto:CAMrKZ99-Ysc-kvySQV=a8Kn7+Sak3qUz1aYzELebOXxsmyBE7w@mail.gmail.com" target="_blank"><font color="blue"><u>CAMrKZ99-Ysc-kvySQV=a8Kn7+Sak3qUz1aYzELebOXxsmyBE7w@mail.gmail.com</u></font></a>></span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Content-Type: text/plain; charset="iso-8859-1"</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;"> </span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Question for folks. What's our position regarding multi-version support within the documentation? For example, there were a number of syntax changes related to logical expressions in 6.0. We
could update the documentation to reflect 6.0 "as is" with no references to how things worked in older versions. We could also try to maintain some backwards compatibility so that the documentation could support all versions. Doing so requires lots of extra
explanation though and makes it harder to maintain. If documentation is version specific then that would argue for historical documentation to be made available...</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;"> </span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Thoughts?</span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;"> </span></font></div>
<div><font face="Consolas" size="2"><span style="font-size: 10.5pt;">Steve</span></font></div>
<div> </div>
<div> </div>
<div> </div>
<div>Mark Volz</div>
<div>GIS Specialist</div>
<div> </div>
<div> </div>
<div> </div>
</span></font>
</div>
</blockquote></div><br>