<div dir="ltr">Nice! The only thing I'd add is that it really needs to be clear what branch the docs are based on. The <a href="https://geographika.github.io/MapServer-documentation/documentation.html">https://geographika.github.io/MapServer-documentation/documentation.html</a> still retains the 7.6.4 version in spots which would be confusing if someone stumbled upon the main branch preview...<div><br></div><div>Stupid question - are <a href="http://mapserv.org">mapserv.org</a> and <a href="http://mapserver.github.io">mapserver.github.io</a> the same thing?</div><div><br></div><div>--Steve</div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Sep 21, 2021 at 3:41 AM Seth G <<a href="mailto:sethg@geographika.co.uk">sethg@geographika.co.uk</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Hi Jeff, all,<br>
<br>
I've created a pull request at <a href="https://github.com/MapServer/MapServer-documentation/pull/610" rel="noreferrer" target="_blank">https://github.com/MapServer/MapServer-documentation/pull/610</a> which puts the output of the `main` branch build into a branch which can be used for GitHub pages (similar to several other OSGeo projects). <br>
It uses a very similar approach as the "live" branch but allows us to view/review docs in main before a backport, or in preparation to a new release. <br>
Beyond setting the gh-pages there is hopefully no further action or maintenance required, and will give us a docs preview URL at <a href="https://mapserver.github.io/MapServer-documentation/" rel="noreferrer" target="_blank">https://mapserver.github.io/MapServer-documentation/</a><br>
<br>
Approach tested and deployed at <a href="https://geographika.github.io/MapServer-documentation/" rel="noreferrer" target="_blank">https://geographika.github.io/MapServer-documentation/</a> but it would be good to have this on a "official" URL. <br>
<br>
Seth<br>
<br>
<br>
--<br>
web:<a href="http://geographika.co.uk" rel="noreferrer" target="_blank">http://geographika.co.uk</a><br>
twitter: @geographika<br>
<br>
On Sat, Sep 18, 2021, at 2:23 AM, Jeff McKenna wrote:<br>
> We are only now a few weeks away from the release (and making the <br>
> current 'main' docs live, as branch-8-0).  I think for our demos in <br>
> these presentations we should continue to do them on our individual <br>
> servers, and then in a few weeks we can push to live. I've got now 20 <br>
> years almost of doc management for MapServer, and I've learned to keep <br>
> it simple, with one branch to maintain live.  (and my experience is here <br>
> unfortunately that those who live multiple live branches visible, or not <br>
> the same people maintaining those live branches and all of that grief). <br>
>   So, keep it simple, until the day I get that 100k contract to maintain <br>
> all of this ;)<br>
><br>
> -jeff<br>
><br>
><br>
><br>
> On 2021-09-17 9:03 p.m., Jeff McKenna wrote:<br>
>> Hi Seth,<br>
>> <br>
>> I see my initial answer then, just a few months ago, still stands for me:<br>
>> <br>
>> "Speaking openly here, if I was paid fulltime to manage the docs and all <br>
>> the different build versions of the docs, and publishing them online, I <br>
>> could see how that would be possible; but as we are made up of <br>
>> volunteers, I would prefer to keep the single version updated with <br>
>> references to when the feature was added (what MapServer version), and <br>
>> if it is deprecated.  I remember recently spending much effort on that <br>
>> in-line versioning improvements, I think that is working nicely now."<br>
>> <br>
>> I recently gave a State of MapServer presentation (last week) and had to <br>
>> give a few demos, but I setup my own server for those demos - for a <br>
>> status report I don't think we should begin a new live branch and then <br>
>> commit to maintain both sets of documents.<br>
>> <br>
>> As part of this I also maintain the PDF versions for the documentation, <br>
>> and generating them - adding another live branch is, just too much.<br>
>> <br>
>> Again, if this was my fulltime paid job, absolutely, bring it on, as I'd <br>
>> be fulltime working on this.  The reality is that, whatever we add here <br>
>> now, in a few years I'll be stuck maintaining by myself.  I honestly <br>
>> prefer, from experience, to stick with one visible/maintained branch of <br>
>> MapServer documentation.<br>
>> <br>
>> -jeff<br>
>> <br>
>> <br>
>> <br>
><br>
><br>
> -- <br>
> Jeff McKenna<br>
> GatewayGeo: Developers of MS4W, MapServer Consulting and Training<br>
> co-founder of FOSS4G<br>
> <a href="http://gatewaygeo.com/" rel="noreferrer" target="_blank">http://gatewaygeo.com/</a><br>
> _______________________________________________<br>
> MapServer-dev mailing list<br>
> <a href="mailto:MapServer-dev@lists.osgeo.org" target="_blank">MapServer-dev@lists.osgeo.org</a><br>
> <a href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><br>
_______________________________________________<br>
MapServer-dev mailing list<br>
<a href="mailto:MapServer-dev@lists.osgeo.org" target="_blank">MapServer-dev@lists.osgeo.org</a><br>
<a href="https://lists.osgeo.org/mailman/listinfo/mapserver-dev" rel="noreferrer" target="_blank">https://lists.osgeo.org/mailman/listinfo/mapserver-dev</a><br>
</blockquote></div>