[docs] Add a download link for a .tar.gz with tutorials (#6986)

* [docs] Add a download link for a .tar.gz with tutorials

Also fix make targets.

Fixes #6520

* bump!

hail/Makefile

@@ -292,6 +292,7 @@ clean-docs:
 .PHONY: docs
 docs: install $(PYTHON_VERSION_INFO)
 	mkdir -p build
+	rm -rf build/www
 	cp -R www build/www
 	mkdir -p build/docs
 	cp -R python/hail/docs build/
@@ -302,14 +303,17 @@ docs: install $(PYTHON_VERSION_INFO)
 	$(MAKE) -C build/www
 	$(MAKE) SPHINXOPTS='-tchecktutorial' -C build/docs BUILDDIR=_build clean html
 	mkdir -p build/www/docs
+	rm -rf build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)
 	mv build/docs/_build/html build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)
+	@echo Built docs: build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)/index.html
 
 .PHONY: test
 test: pytest jvm-test doctest tutorial-test
 
 .PHONY: tutorial-test
 docs-no-test: $(PYTHON_VERSION_INFO)
 	mkdir -p build
+	rm -rf build/www
 	cp -R www build/www
 	mkdir -p build/docs
 	cp -R python/hail/docs build/
@@ -320,7 +324,9 @@ docs-no-test: $(PYTHON_VERSION_INFO)
 	$(MAKE) -C build/www
 	$(MAKE) -C build/docs BUILDDIR=_build clean html
 	mkdir -p build/www/docs
+	rm -rf build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)
 	mv build/docs/_build/html build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)
+	@echo Built docs: build/www/docs/$(HAIL_MAJOR_MINOR_VERSION)/index.html
 
 .PHONY: native-lib native-lib-test native-lib-clean native-lib-prebuilt native-lib-reset-prebuilt
 native-lib:

hail/python/hail/docs/Makefile

@@ -52,8 +52,13 @@ check-python:
 	@echo "Ensuring that Hail can be imported..."
 	python3 -c "import hail"
 
+.PHONY: tutorials-tar
+tutorials-tar:
+	mkdir -p $(BUILDDIR)/html
+	tar cvf $(BUILDDIR)/html/tutorials.tar.gz tutorials
+
 .PHONY: html
-html: check-python
+html: check-python tutorials-tar
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."

hail/python/hail/docs/tutorials-landing.rst

@@ -5,7 +5,8 @@ Hail Tutorials
 ==============
 
 To take Hail for a test drive, go through our tutorials. These can be viewed here in the documentation,
-but we recommend instead that you run them yourself with Jupyter.
+but we recommend instead that you run them yourself with Jupyter by
+`downloading the archive (.tar.gz) <tutorials.tar.gz>`__.
 
 .. toctree::
     :maxdepth: 1