Skip to content

Commit a6c03c7

Browse files
committed
chore: configure documentation deployment and update mkdocs settings
- Add GitHub Actions workflow for automated docs deployment - Add docs/requirements.txt for documentation dependencies - Remove mkdocs-jupyter plugin from mkdocs.yml - Update sft_rm.md documentation - Remove docs/examples symlink - Add .env to .gitignore
1 parent ceab97e commit a6c03c7

File tree

6 files changed

+68
-4
lines changed

6 files changed

+68
-4
lines changed

.github/workflows/deploy-docs.yml

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
name: Deploy MkDocs to GitHub Pages
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
workflow_dispatch:
8+
9+
permissions:
10+
contents: read
11+
pages: write
12+
id-token: write
13+
14+
concurrency:
15+
group: pages
16+
cancel-in-progress: false
17+
18+
jobs:
19+
build:
20+
runs-on: ubuntu-latest
21+
steps:
22+
- name: Checkout repository
23+
uses: actions/checkout@v4
24+
with:
25+
fetch-depth: 0
26+
27+
- name: Setup Python
28+
uses: actions/setup-python@v5
29+
with:
30+
python-version: '3.11'
31+
32+
- name: Cache pip dependencies
33+
uses: actions/cache@v4
34+
with:
35+
path: ~/.cache/pip
36+
key: ${{ runner.os }}-pip-${{ hashFiles('docs/requirements.txt') }}
37+
restore-keys: |
38+
${{ runner.os }}-pip-
39+
40+
- name: Install dependencies
41+
run: |
42+
pip install --upgrade pip
43+
pip install -r docs/requirements.txt
44+
45+
- name: Build documentation
46+
run: mkdocs build --clean
47+
48+
- name: Upload artifact
49+
uses: actions/upload-pages-artifact@v3
50+
with:
51+
path: ./site
52+
53+
deploy:
54+
environment:
55+
name: github-pages
56+
url: ${{ steps.deployment.outputs.page_url }}
57+
runs-on: ubuntu-latest
58+
needs: build
59+
steps:
60+
- name: Deploy to GitHub Pages
61+
id: deployment
62+
uses: actions/deploy-pages@v4

.gitignore

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,4 +16,4 @@ docs/log
1616
.python-version
1717
tests/plt_*
1818
/site
19-
poetry.lock
19+
poetry.lock.env

docs/examples

Lines changed: 0 additions & 1 deletion
This file was deleted.

docs/requirements.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
mkdocs>=1.5.0
2+
mkdocs-material>=9.0.0
3+
mkdocstrings[python]>=0.24.0
4+
pymdown-extensions>=10.0
5+
mkdocs-shadcn>=0.1.0

docs/tutorial/training_rm/sft_rm.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22

33
This directory contains training scripts for fine-tuning a Reasoning Reward Model based on the VERL framework. The model is designed to evaluate and score responses based on their reasoning quality, supporting both single-node and multi-node distributed training.
44

5-
[sft_rm.sh](../../../examples/train/sft/sft_rm.sh)
65

76
## Training Approaches Overview
87

mkdocs.yml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,6 @@ plugins:
6767
min_search_length: 2
6868
prebuild_index: true
6969
indexing: 'full'
70-
- mkdocs-jupyter
7170
- mkdocstrings:
7271
handlers:
7372
python:

0 commit comments

Comments
 (0)