Add script to fix H1s on Dokka-generated docs (#1460)

* Add script to fix H1s on Dokka-generated docs

This is an SEO team request to make sure all pages have an H1.

* Verified script execution in development environment

---------

Co-authored-by: Claus Rørbech <claus.rorbech@mongodb.com>

tools/fix-h1s.sh

@@ -0,0 +1,22 @@
+#!/bin/bash -ex
+
+usage() {
+cat <<EOF
+Usage: $0 <root-dokka-dir>
+EOF
+}
+
+if [ "$#" -ne 1 ] ; then
+  usage
+  exit 1
+fi
+
+# Assume Dokka has been run
+pushd $1
+
+# Make the output SEO friendly by converting the "h2" title to the proper "h1".
+# For Dokka, this is only an issue on the index page (apparently).
+sed -i -e 's|<h2\(.*\)</h2>|<h1\1</h1>|' index.html
+find . -iname "*.html-e" | xargs rm
+
+popd

tools/publish_release.sh

@@ -108,6 +108,7 @@ create_javadoc() {
   echo "Creating JavaDoc/KDoc..."
   cd $REALM_KOTLIN_PATH/packages
   ./gradlew dokkaHtmlMultiModule --info --stacktrace --no-daemon
+  ../tools/fix-h1s.sh build/dokka/htmlMultiModule
   cd $HERE
 }