[geos-devel] PSC Vote: Host geos.osgeo.org on GH pages

[Paul Ramsey]

> On Aug 24, 2021, at 5:55 AM, Howard Butler <howard at hobu.co> wrote:
> 
> 
> 
>> On Aug 24, 2021, at 5:10 AM, Sandro Santilli <strk at kbt.io> wrote:
>> 
>>> You guys hate the evil GitHub empire, but the way to do this is to create a GitHub action that pushes the site whenever  the branch that contains the active docs is pushed. See PROJ, PDAL, GDAL, and others for examples of this pattern working successfully for large projects.
>> 
>> There's no hate on my side, just love for independence :)
>> 
>> I debate there's one "way to do this", luckly for all of us.
> 
> One of the many advantages of the GDAL, PDAL, and PROJ documentation setup is we practically never have to mess with it. It just works. When it doesn't work, or when someone wants to make a documentation contribution, anyone can do so with a pull request and iterate until they succeed. No special access or special knowledge required. 
> 
> Additionally, GEOS should house its documentation at a top level domain (like libgeos.org or something) rather than a subdomain of osgeo (ala geos.osgeo.org). This is because the search engine indexes penalize content at subdomains, and the most important control element for documentation is having a domain the project can point wherever it wants. 

I honestly don't know where I landed in my web site work, it was a coulpe months ago, but I'll dig it out when I get back from the Beach. I did look closely at hugo, and may have chosen it. My main desire was something with a really fine theme for doco that also was cleanly responsive. The best one of those was I'm pretty sure the RTD sphinx theme. There were some copies in hugo that weren't quite as nice. Hugo from a systems perspective is nice wrt platform independence, but sphinx-in-a-docker-container can achieve much the same effect. Just need a good README with good directions on the magic incantation to build out.

More after the Beach,
P

> 
> Howard
> _______________________________________________
> geos-devel mailing list
> geos-devel at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/geos-devel