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

[Howard Butler]

> 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. 

Howard