[PROJ] Motion: Migrate proj.org to ReadTheDocs

[Kristian Evers]

First of all, good job on this Howard and Mike. Thanks for taking the lead and following through with both the admin and grunt work!

I too am +0 for this but it can easily be turned into a +1:

RTD is great and the doc versioning is a killer feature. In light of Alan’s previous experiencing I’d like to have a basic contingency plan in case RTD turns out to not be great fit for the project in the long run. Returning back to GitHub Pages is the obvious solution to that problem. How big a pain is it to redirect proj.org <http://proj.org/> away from RTD again if things turn south?

/Kristian

> On 3 Feb 2023, at 23.19, Alan Snow <alansnow21 at gmail.com> wrote:
> 
> +0
> 
> A few years ago, I had a less than great experience with RTD due to instability and lack of ability to be able to fix underlying issues with a highly constrained environment. I have found not using it to be a painless experience. However, it seems like they have been actively developing it and it does have some nice features. So, it is likely worth trying out.
> 
> On Fri, Feb 3, 2023, 2:46 PM Charles Karney <charles.karney at gmail.com <mailto:charles.karney at gmail.com>> wrote:
> +1
> Charles
> 
> On 2/3/23 14:00, Howard Butler wrote:
> > All,
> > 
> > I would like to motion to migrate proj.org <http://proj.org/> <http://proj.org <http://proj.org/>> from our 
> > self-managed GitHub Pages-based deployment to one based on ReadTheDocs 
> > (RTD). The new deployment will host multi-versioned content all the way 
> > back to 5.0 thanks to Mike Taves.
> > 
> > As I mentioned in a previous email, the RTD deployment is temporarily 
> > pointed at https://pointcloud.org <https://pointcloud.org/> <https://pointcloud.org <https://pointcloud.org/>> to simulate a 
> > domain deployment on OSGeo's DNS infrastructure. When the motion passes, 
> > we will simply move the pointer to proj.org <http://proj.org/> <http://proj.org <http://proj.org/>> The 
> > deployment currently has RTD's ad network enabled, but this will be 
> > removed once the sponsorship purchase process completes its move through 
> > OSGeo. The migration to RTD brings us some useful benefits such as 
> > documentation rendering in PRs, convenient multi-versioned doc hosting, 
> > and a reduction of our volunteer time consumed by documentation system 
> > management.
> > 
> > PROJ's docs are comprehensive, thorough, and beautiful, and they rival 
> > the Snyder book for projection math, examples, and graphics. Thank you 
> > to all of the contributors who have helped bring PROJ's docs forward to 
> > a much better place [1].
> > 
> > + 1
> > 
> > Howard
> > 
> > 
> > [1] We're a long way past the Trac wiki and some outbound pointers 
> > https://web.archive.org/web/20140226080407/trac.osgeo.org/proj <https://web.archive.org/web/20140226080407/trac.osgeo.org/proj> 
> > <https://web.archive.org/web/20140226080407/trac.osgeo.org/proj <https://web.archive.org/web/20140226080407/trac.osgeo.org/proj>>
> > 
> > _______________________________________________
> > PROJ mailing list
> > PROJ at lists.osgeo.org <mailto:PROJ at lists.osgeo.org>
> > https://lists.osgeo.org/mailman/listinfo/proj <https://lists.osgeo.org/mailman/listinfo/proj>
> 
> -- 
> Charles Karney <charles at karney.com <mailto:charles at karney.com>>
> 702 Prospect Ave
> Princeton, NJ 08540-4037
> _______________________________________________
> PROJ mailing list
> PROJ at lists.osgeo.org <mailto:PROJ at lists.osgeo.org>
> https://lists.osgeo.org/mailman/listinfo/proj <https://lists.osgeo.org/mailman/listinfo/proj>
> _______________________________________________
> PROJ mailing list
> PROJ at lists.osgeo.org
> https://lists.osgeo.org/mailman/listinfo/proj

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/proj/attachments/20230204/942cd1b7/attachment.htm>