> On Aug 24, 2021, at 5:10 AM, Sandro Santilli <s...@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
_______________________________________________
geos-devel mailing list
geos-devel@lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/geos-devel
