> On Aug 24, 2021, at 5:55 AM, Howard Butler <how...@hobu.co> wrote:
>
>
>
>> 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.
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@lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/geos-devel
_______________________________________________
geos-devel mailing list
geos-devel@lists.osgeo.org
https://lists.osgeo.org/mailman/listinfo/geos-devel
