Migrate organization websites

[redeboer]

The pages for this repository are currently hosted on RTD. Its URL is a bit ugly though (compwa-org.rtfd.io), especially since the original ComPWA C++ project has been archived and ComPWA is to be considered an organization anyway.

Since the pages for compwa-org on RTD are not versioned, we could host them on GitHub Pages, particularly on the namespace for the ComPWA GitHub organization (compwa.github.io). That URL currently hosts pycompwa's documentation, but that could be moved to compwa.github.io/pycompwa. The only thing that's lost is the ability to have PR previews, but that could be kept by just letting compwa-org.rtfd.io redirect to compwa.github.io (see RTD redirects).

ComPWA ++ / pycompwa

Preview Give feedback

1. compwa.github.io → compwa.github.io/pycompwa
2. github.com/ComPWA/ComPWA → github.com/ComPWA/ComPWA-legacy
3. compwa.rtfd.io → compwa.github.io/legacy
4. compwa.github.io/ComPWA → compwa.github.io/legacy-doxygen

Organization page redirects

Preview Give feedback

1. github.com/ComPWA/compwa-org → github.com/ComPWA/compwa.github.io
2. Build PR previews on compwa.rtfd.io
3. DOC: migrate to compwa.github.io #234
   📝 Docs +1
   
4. Test redirects of entires pages on RTD including subpages. Optionally, use sphinx-reredirects (absolute redirects) or sphinxext-rediraffe (Git diffs)
5. compwa-org.rtfd.io → compwa.rtfd.io
6. compwa.rtfd.io → compwa.github.io, but keep PR preview on compwa.rtfd.io
7. Update links to pages, see "compwa-org.r" code search

[redeboer]

Here's a bash script for checking which ComPWA GitHub pages exist using the gh CLI:

COMPWA_REPOS=$(gh repo list ComPWA --visibility=public --json name --jq '.[].name' | sort -f)
COMPWA_PAGES=()
for repo in $COMPWA_REPOS; do
  URL="https://compwa.github.io"
  if [[ $repo != "compwa.github.io" ]]; then
    URL="$URL/$repo"
  fi
  response=$(curl -s --head -w "%{http_code}" $URL -o /dev/null)
  if [[ $response -eq 200 ]] || [[ $response -eq 301 ]]; then
    COMPWA_PAGES+="$URL "
  fi
done
for page in $(echo "${COMPWA_PAGES[@]}" | tr ' ' '\n' | sort); do
  echo $page
done

As of writing, these are:

URL
compwa.github.io
compwa.github.io/ampform-dpd
compwa.github.io/benchmarks
compwa.github.io/gluex-amplitude
compwa.github.io/legacy	ComPWA++ Sphinx API
compwa.github.io/legacy-doxygen	ComPWA++ Doxygen API
compwa.github.io/polarimetry
compwa.github.io/policy
compwa.github.io/pycompwa	pycompwa
compwa.github.io/strong2020-salamanca
compwa.github.io/tensorwaves

[redeboer]

Forced redirects from RTD work again since v10.15.1 🎉
https://docs.readthedocs.io/en/stable/changelog.html#version-10-15-1