Merge pull request OSGeo#3743 from mwtoews/doc-build-cleanup

Doc/CI: Transition to ReadTheDocs, clean-up previous methods

Author: rouault

.github/workflows/doc_build.yml

@@ -182,8 +182,6 @@ See step 1.6 above. Do not rename the archives with RC postfixes.
     :s/^o/*/
 
   - Update download links in `docs/source/download.rst`
-  - Update `$TRAVIS_BRANCH` in `travis\after_success.sh` to new maintenance
-    branch.
 
 
 
@@ -241,13 +239,17 @@ version numbers in the files.
 *Commit changes. Either to master or maintenance branch depending on the nature
 of the release.*
 
-3.2 Disable website deployment when releasing a new non-bugfix version
+3.2 Documentation
 -------------------------------------------------------------------------------
 
-If the previous active version was, let's say, 6.1 and the new version is, let's say, 6.2,
-then checkout 6.1 branch, and in travis/after_success.sh, remove the code
-that causes commits to 6.1 to cause a website refresh, that is remove the
-code under `if test "$TRAVIS_SECURE_ENV_VARS" = "true" -a "$TRAVIS_BRANCH" = "6.1"; then`.
+HTML and PDF documentation is built using ReadTheDocs, which supports multiple
+versions. Versions are based on branch labels, e.g. "9.2". To modify settings,
+registered users must first log in. To add a version, go to
+https://readthedocs.org/projects/osgeo-proj/versions/ and click "Activate"
+next to the maintenance branch label.
+
+The latest maintenance branch should be set as the "Default version" found at
+https://readthedocs.org/dashboard/osgeo-proj/advanced/
 
 Also edit docs/source/conf.py to change the active branch for documentation
 in the `github_version` variable.

HOWTO-RELEASE

@@ -15,7 +15,6 @@ Current Release
 
 * **2023-03-01** `proj-9.2.0.tar.gz`_ (`md5`_)
 * **2023-03-01** `proj-data-1.13.tar.gz`_
-* **PDF Manual** `proj.pdf`_
 
 .. note::
 
@@ -163,4 +162,3 @@ Past Releases
 .. _`proj-datumgrid-oceania-1.1.zip`: https://download.osgeo.org/proj/proj-datumgrid-oceania-1.1.zip
 .. _`proj-datumgrid-oceania-1.2.zip`: https://download.osgeo.org/proj/proj-datumgrid-oceania-1.2.zip
 .. _`proj-datumgrid-world-1.0.zip`: https://download.osgeo.org/proj/proj-datumgrid-world-1.0.zip
-.. _`proj.pdf`: https://raw.githubusercontent.com/OSGeo/PROJ/gh-pages/proj.pdf

docs/source/download.rst

@@ -31,8 +31,3 @@ PROJ
     You can download the source code for PROJ on the :ref:`download section<download>`
     and find links to prepackaged executables in the
     :ref:`installation section<install>`.
-
-    In addition to this website the PROJ documentation is also available in `PDF`_
-    form.
-
-.. _`PDF`: https://raw.githubusercontent.com/OSGeo/proj.4/gh-pages/proj.pdf