Checkout current docs setup from scylla-4.x branch

Main motivation is getting myst parser in, so that documentation builds
correctly for this version.
Brings several changes that are in scylla-4.x as of commit
c85f7b9

Author: Bouncheck

docs/Makefile

@@ -24,11 +24,14 @@ setupenv:
 .PHONY: setup
 setup:
 	$(POETRY) install
-	$(POETRY) update
 	@if [ ! -d "$(SOURCEDIR)" ]; then mkdir -p "$(SOURCEDIR)"; fi
 	cp -RL source/* $(SOURCEDIR)
 	cd $(SOURCEDIR) && find . -name README.md -execdir mv '{}' index.md ';'
 
+.PHONY: update
+update:
+	$(POETRY) update
+
 # Clean commands
 .PHONY: pristine
 pristine: clean

docs/_utils/deploy.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# Copy contents
+mkdir gh-pages
+cp -r ./docs/_build/dirhtml/. gh-pages
+
+# Create gh-pages branch
+cd gh-pages
+git init
+git config --local user.email "[email protected]"
+git config --local user.name "GitHub Action"
+git remote add origin "https://x-access-token:${GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git"
+git checkout -b gh-pages
+
+# Deploy
+git add .
+git commit -m "Publish docs" || true
+git push origin gh-pages --force

docs/_utils/javadoc.sh

@@ -14,4 +14,4 @@ fi
 mvn javadoc:javadoc -T 1C
 [ -d $OUTPUT_DIR ] && rm -r $OUTPUT_DIR
 mkdir -p "$OUTPUT_DIR"
-mv -f core/target/site/apidocs/* $OUTPUT_DIR
+mv -f driver-core/target/site/apidocs/* $OUTPUT_DIR