[Doc] sphinx documentation with content reformatting

.gitattributes

@@ -1,6 +1,7 @@
 *               text=auto whitespace=trailing-space,space-before-tab,-indent-with-non-tab,tab-in-indent,tabwidth=4
 
 .git*           text export-ignore
+Makefile        text whitespace=-tab-in-indent
 
 *.txt           text
 *.htm           text

.github/workflows/github_pages.yml

@@ -56,4 +56,5 @@ jobs:
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ./public
+          destination_dir: legacy
           force_orphan: true

site/source/Makefile → docs/Makefile

@@ -5,16 +5,21 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = site/source
-BUILDDIR      = site/static/api
+SOURCEDIR     = source
+BUILDDIR      = build
 
 # Put it first so that "make" without argument is like "make help".
 help:
-    @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 .PHONY: help Makefile
 
+html:
+	@$(SPHINXBUILD) -b html "$(SOURCEDIR)" "$(BUILDDIR)"/html $(SPHINXOPTS) $(O)
+
+	cp source/_static/redirects/guide-homepage-redirect.html "$(BUILDDIR)"/html/index.html
+
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-    @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

site/content/en/docs/contributing.md → docs/contributing.md

@@ -1,9 +1,4 @@
----
-title: 'Contribution Guide'
-linkTitle: 'Contributing'
-description: ''
-weight: 50
----
+# Contribution Guide
 
 ## Related sections