Repository files navigation

We recommend new contributors start from writing documentation, which helps you quickly understand SGLang codebase.Most documentation files are located under thedocs/ folder.

apt-get update&& apt-get install -y pandoc parallel retrypip install -r requirements.txt

Update your Jupyter notebooks in the appropriate subdirectories underdocs/. If you add new files, remember to updateindex.rst (or relevant.rst files) accordingly.

• pre-commit run --all-files manually runs all configured checks, applying fixes if possible. If it fails the first time, re-run it to ensure lint errors are fully resolved. Make sure your code passes all checksbefore creating a Pull Request.

# 1) Compile all Jupyter notebooksmake compile# This step can take a long time (10+ mins). You can consider skipping this step if you can make sure your added files are correct.make html# 2) Compile and Preview documentation locally with auto-build# This will automatically rebuild docs when files change# Open your browser at the displayed port to view the docsbash serve.sh# 2a) Alternative ways to serve documentation# Directly use make servemake serve# With custom portPORT=8080 make serve# 3) Clean notebook outputs# nbstripout removes notebook outputs so your PR stays cleanpip install nbstripoutfind. -name'*.ipynb' -exec nbstripout {}\;# 4) Pre-commit checks and create a PR# After these checks pass, push your changes and open a PR on your branchpre-commit run --all-files

• For common functionalities, we preferJupyter Notebooks over Markdown so that all examples can be executed and validated by our docs CI pipeline. For complex features (e.g., distributed serving), Markdown is preferred.
• Keep in mind the documentation execution time when writing interactive Jupyter notebooks. Each interactive notebook will be run and compiled against every commit to ensure they are runnable, so it is important to apply some tips to reduce the documentation compilation time:
  • Use small models (e.g.,qwen/qwen2.5-0.5b-instruct) for most cases to reduce server launch time.
  • Reuse the launched server as much as possible to reduce server launch time.
• Do not use absolute links (e.g.,https://docs.sglang.ai/get_started/install.html). Always prefer relative links (e.g.,../get_started/install.md).
• Follow the existing examples to learn how to launch a server, send a query and other common styles.