ceph/admin/rtd-checkout-main

# See .readthedocs.yml
set -ex
re='^[0-9]+$'
if [[ $READTHEDOCS_VERSION =~ $re ]]; then
  echo "Building docs for PR $READTHEDOCS_VERSION.  Will not check out doc/releases from main branch."
else
  echo "Building docs for $READTHEDOCS_VERSION branch.  Will check out doc/releases from main branch."
  git checkout origin/main -- doc/releases
fi
git status
.readthedocs.yml: Always build latest doc/releases pages We don't backport PRs merged into doc/releases. Therefore, when one browses to an older Ceph release version on docs.ceph.com (e.g., https://docs.ceph.com/en/pacific/), the information is out of date at best. The doc/releases page is only accurate if browsing https://docs.ceph.com/en/latest/, for example. So this post_checkout command will make sure we've checked out doc/releases from main before building and publishing. Signed-off-by: David Galloway <dgallowa@redhat.com> 2022-06-30 19:37:58 +00:00			`# See .readthedocs.yml`
			`set -ex`
admin: Fix check if PR or release branch docs build Uses built-in RTD vars. https://docs.readthedocs.io/en/stable/environment-variables.html. Follow up to https://github.com/ceph/ceph/pull/46917#discussion_r942359130. Signed-off-by: David Galloway <dgallowa@redhat.com> 2022-08-22 20:29:01 +00:00			`re='^[0-9]+$'`
			`if [[ $READTHEDOCS_VERSION =~ $re ]]; then`
			`echo "Building docs for PR $READTHEDOCS_VERSION. Will not check out doc/releases from main branch."`
			`else`
			`echo "Building docs for $READTHEDOCS_VERSION branch. Will check out doc/releases from main branch."`
.readthedocs.yml: Always build latest doc/releases pages We don't backport PRs merged into doc/releases. Therefore, when one browses to an older Ceph release version on docs.ceph.com (e.g., https://docs.ceph.com/en/pacific/), the information is out of date at best. The doc/releases page is only accurate if browsing https://docs.ceph.com/en/latest/, for example. So this post_checkout command will make sure we've checked out doc/releases from main before building and publishing. Signed-off-by: David Galloway <dgallowa@redhat.com> 2022-06-30 19:37:58 +00:00			`git checkout origin/main -- doc/releases`
			`fi`
			`git status`