docs: update readthedocs

.clang-format

@@ -1 +1 @@
-BasedOnStyle:  Google
+BasedOnStyle: Google

.dockerignore

@@ -0,0 +1 @@
+.gitignore

.github/ISSUE_TEMPLATE/bug_report.md

@@ -23,24 +23,26 @@ Please use the markdown code blocks for both code and stack traces.
 import torchopt
 ```
 
-```bash
+```pytb
 Traceback (most recent call last):
-  File ... 
+  File ...
 ```
 
 ## Expected behavior
 
 A clear and concise description of what you expected to happen.
 
 ## Screenshots
+
 If applicable, add screenshots to help explain your problem.
 
 ## System info
 
 Describe the characteristic of your environment:
- * Describe how the library was installed (pip, source, ...)
- * Python version
- * Versions of any other relevant libraries
+
+- Describe how the library was installed (pip, source, ...)
+- Python version
+- Versions of any other relevant libraries
 
 ```python
 import torchopt, numpy, sys

.github/PULL_REQUEST_TEMPLATE.md

@@ -8,7 +8,7 @@ Why is this change required? What problem does it solve?
 If it fixes an open issue, please link to the issue here.
 You can use the syntax `close #15213` if this solves the issue #15213
 
-- [ ] I have raised an issue to propose this change ([required](https://torchopt.readthedocs.io/en/latest/pages/contributing.html) for new features and bug fixes)
+- [ ] I have raised an issue to propose this change ([required](https://github.com/metaopt/TorchOpt/issues) for new features and bug fixes)
 
 ## Types of changes
 
@@ -32,7 +32,7 @@ What types of changes does your code introduce? Put an `x` in all the boxes that
 Go over all the following points, and put an `x` in all the boxes that apply.
 If you are unsure about any of these, don't hesitate to ask. We are here to help!
 
-- [ ] I have read the [CONTRIBUTION](https://torchopt.readthedocs.io/en/latest/pages/contributing.html) guide (**required**)
+- [ ] I have read the [CONTRIBUTION](https://torchopt.readthedocs.io/en/latest/developer/contributing.html) guide (**required**)
 - [ ] My change requires a change to the documentation.
 - [ ] I have updated the tests accordingly (*required for a bug fix or a new feature*).
 - [ ] I have updated the documentation accordingly.

.github/workflows/lint.yml

@@ -2,6 +2,8 @@ name: Lint
 
 on:
   push:
+    branches:
+      - main
   pull_request:
 
 permissions:
@@ -23,7 +25,7 @@ jobs:
           submodules: "recursive"
           fetch-depth: 1
 
-      - name: Set up Python 3.7  # the lowest version we support
+      - name: Set up Python 3.7 # the lowest version we support
         uses: actions/setup-python@v4
         with:
           python-version: "3.7"
@@ -37,30 +39,53 @@ jobs:
           method: network
           sub-packages: '["nvcc"]'
       - run: |
-          echo "Installed CUDA version is: ${{steps.cuda-toolkit.outputs.cuda}}"
+          CUDA_VERSION="${{steps.cuda-toolkit.outputs.cuda}}"
+          echo "CUDA_VERSION='${CUDA_VERSION}'" >> "${GITHUB_ENV}"
+          TORCH_INDEX_URL="https://download.pytorch.org/whl/cu$(echo "${CUDA_VERSION}" | cut -d'.' -f-2  | tr -d '.')"
+          echo "TORCH_INDEX_URL='${TORCH_INDEX_URL}'" >> "${GITHUB_ENV}"
+
+          echo "Installed CUDA version is: ${CUDA_VERSION}"
           echo "CUDA install location: ${{steps.cuda-toolkit.outputs.CUDA_PATH}}"
           nvcc -V
+          echo "Torch index URL: ${TORCH_INDEX_URL}"
 
       - name: Upgrade pip
         run: |
           python -m pip install --upgrade pip setuptools
 
       - name: Install dependencies
         run: |
-          python -m pip install -r tests/requirements.txt
+          python -m pip install --extra-index-url "${TORCH_INDEX_URL}" \
+            -r tests/requirements.txt -r docs/requirements.txt
 
       - name: Install TorchOpt
         run: |
           python -m pip install -e .
 
+      - name: pre-commit
+        run: |
+          make pre-commit
+
       - name: flake8
         run: |
           make flake8
 
-      - name: isort and yapf
+      - name: pylint
+        run: |
+          make pylint
+
+      - name: isort and black
         run: |
           make py-format
 
+      - name: cpplint
+        run: |
+          make cpplint
+
+      - name: clang-format
+        run: |
+          make clang-format
+
       - name: addlicense
         run: |
           make addlicense
@@ -69,10 +94,10 @@ jobs:
         run: |
           make mypy
 
-    # - name: docstyle
-    #   run: |
-    #     make docstyle
+      - name: docstyle
+        run: |
+          make docstyle
 
-    # - name: spelling
-    #   run: |
-    #     make spelling
+      - name: spelling
+        run: |
+          make spelling

.github/workflows/tests.yml

@@ -39,17 +39,24 @@ jobs:
           method: network
           sub-packages: '["nvcc"]'
       - run: |
-          echo "Installed CUDA version is: ${{steps.cuda-toolkit.outputs.cuda}}"
+          CUDA_VERSION="${{steps.cuda-toolkit.outputs.cuda}}"
+          echo "CUDA_VERSION='${CUDA_VERSION}'" >> "${GITHUB_ENV}"
+          TORCH_INDEX_URL="https://download.pytorch.org/whl/cu$(echo "${CUDA_VERSION}" | cut -d'.' -f-2  | tr -d '.')"
+          echo "TORCH_INDEX_URL='${TORCH_INDEX_URL}'" >> "${GITHUB_ENV}"
+
+          echo "Installed CUDA version is: ${CUDA_VERSION}"
           echo "CUDA install location: ${{steps.cuda-toolkit.outputs.CUDA_PATH}}"
           nvcc -V
+          echo "Torch index URL: ${TORCH_INDEX_URL}"
 
       - name: Upgrade pip
         run: |
           python -m pip install --upgrade pip setuptools
 
       - name: Install dependencies
         run: |
-          python -m pip install -r tests/requirements.txt
+          python -m pip install --extra-index-url "${TORCH_INDEX_URL}" \
+            -r tests/requirements.txt
 
       - name: Install TorchOpt
         run: |