SWDEV-428554 - Standardize HIP Documentation

Relates to https://github.com/RadeonOpenCompute/rocm-docs-core/issues/330

Change-Id: I87468935a1aefa60158b8c07e3911845b3e8da36

docs/sphinx/_toc.yml.in

@@ -0,0 +1,29 @@
+root: index
+subtrees:
+- caption: User Guide
+  entries:
+    - file: user_guide/programming_manual
+    - file: user_guide/hip_rtc
+    - file: user_guide/faq
+    - file: user_guide/hip_porting_guide
+    - file: user_guide/hip_porting_driver_api
+- caption: How to Guides
+  entries:
+  - file: how_to_guides/install.md
+  - file: how_to_guides/debugging.md
+- caption: Reference
+  entries:
+  - file: doxygen/html/index
+  - file: reference/kernel_language
+  - file: reference/math_api
+  - file: reference/terms
+  - file: reference/glossary
+  - file: reference/deprecated_api_list
+- caption: Developer Guide
+  entries:
+  - file: developer_guide/build
+  - file: developer_guide/logging
+  - file: developer_guide/contributing.md
+- caption: About
+  entries:
+  - file: license

docs/sphinx/requirements.in

@@ -0,0 +1 @@
+rocm-docs-core[api_reference]==0.26.0

docs/sphinx/requirements.txt

@@ -0,0 +1,165 @@
+#
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
+#
+#    pip-compile requirements.in
+#
+accessible-pygments==0.0.3
+    # via pydata-sphinx-theme
+alabaster==0.7.12
+    # via sphinx
+babel==2.10.3
+    # via
+    #   pydata-sphinx-theme
+    #   sphinx
+beautifulsoup4==4.11.1
+    # via pydata-sphinx-theme
+breathe==4.34.0
+    # via rocm-docs-core
+certifi==2022.6.15
+    # via requests
+cffi==1.15.1
+    # via
+    #   cryptography
+    #   pynacl
+charset-normalizer==2.1.0
+    # via requests
+click==8.1.3
+    # via
+    #   click-log
+    #   doxysphinx
+    #   sphinx-external-toc
+click-log==0.4.0
+    # via doxysphinx
+cryptography==40.0.2
+    # via pyjwt
+deprecated==1.2.13
+    # via pygithub
+docutils==0.16
+    # via
+    #   breathe
+    #   myst-parser
+    #   pydata-sphinx-theme
+    #   sphinx
+doxysphinx==3.3.7
+    # via rocm-docs-core
+fastjsonschema==2.16.2
+    # via rocm-docs-core
+gitdb==4.0.10
+    # via gitpython
+gitpython==3.1.31
+    # via rocm-docs-core
+idna==3.3
+    # via requests
+imagesize==1.4.1
+    # via sphinx
+jinja2==3.1.2
+    # via
+    #   myst-parser
+    #   sphinx
+libsass==0.22.0
+    # via doxysphinx
+lxml==4.9.2
+    # via doxysphinx
+markdown-it-py==2.1.0
+    # via
+    #   mdit-py-plugins
+    #   myst-parser
+markupsafe==2.1.1
+    # via jinja2
+mdit-py-plugins==0.3.5
+    # via myst-parser
+mdurl==0.1.2
+    # via markdown-it-py
+mpire==2.8.0
+    # via doxysphinx
+myst-parser==1.0.0
+    # via rocm-docs-core
+packaging==21.3
+    # via
+    #   pydata-sphinx-theme
+    #   sphinx
+pycparser==2.21
+    # via cffi
+pydata-sphinx-theme==0.13.3
+    # via
+    #   rocm-docs-core
+    #   sphinx-book-theme
+pygithub==1.58.2
+    # via rocm-docs-core
+pygments==2.12.0
+    # via
+    #   accessible-pygments
+    #   mpire
+    #   pydata-sphinx-theme
+    #   sphinx
+pyjson5==1.6.4
+    # via doxysphinx
+pyjwt[crypto]==2.6.0
+    # via pygithub
+pynacl==1.5.0
+    # via pygithub
+pyparsing==3.0.9
+    # via
+    #   doxysphinx
+    #   packaging
+pytz==2022.1
+    # via babel
+pyyaml==6.0
+    # via
+    #   myst-parser
+    #   rocm-docs-core
+    #   sphinx-external-toc
+requests==2.28.1
+    # via
+    #   pygithub
+    #   sphinx
+rocm-docs-core[api_reference]==0.26.0
+    # via -r requirements.in
+smmap==5.0.0
+    # via gitdb
+snowballstemmer==2.2.0
+    # via sphinx
+soupsieve==2.3.2.post1
+    # via beautifulsoup4
+sphinx==5.3.0
+    # via
+    #   breathe
+    #   myst-parser
+    #   pydata-sphinx-theme
+    #   rocm-docs-core
+    #   sphinx-book-theme
+    #   sphinx-copybutton
+    #   sphinx-design
+    #   sphinx-external-toc
+    #   sphinx-notfound-page
+sphinx-book-theme==1.0.1
+    # via rocm-docs-core
+sphinx-copybutton==0.5.1
+    # via rocm-docs-core
+sphinx-design==0.3.0
+    # via rocm-docs-core
+sphinx-external-toc==0.3.1
+    # via rocm-docs-core
+sphinx-notfound-page==0.8.3
+    # via rocm-docs-core
+sphinxcontrib-applehelp==1.0.2
+    # via sphinx
+sphinxcontrib-devhelp==1.0.2
+    # via sphinx
+sphinxcontrib-htmlhelp==2.0.0
+    # via sphinx
+sphinxcontrib-jsmath==1.0.1
+    # via sphinx
+sphinxcontrib-qthelp==1.0.3
+    # via sphinx
+sphinxcontrib-serializinghtml==1.1.5
+    # via sphinx
+tqdm==4.66.1
+    # via mpire
+typing-extensions==4.4.0
+    # via pydata-sphinx-theme
+urllib3==1.26.11
+    # via requests
+wrapt==1.15.0
+    # via deprecated