apache/sedona

Document how to build and change the documentation

Open

#1,727 opened on 2024年12月18日

GitHub で見る
 (8 comments) (0 reactions) (0 assignees)Scala (1,953 stars) (693 forks)batch import
attention neededbugdocsgood first issuehelp wantedin progressquestion

説明

Expected behavior: Setup instructions on how to build the documentation locally.

Actual behavior: User has to figure out how to build the documentation site locally (it's not hard, but would be easier with instructions).

Suggested change: explain how the user can build a virtual environment with the required dependencies and add contribution instructions on how to build the documentation site locally.

コントリビューターガイド

技術スタック
pythonshell
領域
documentationdeveloper experience
Issue 種別
documentation
難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。
2
推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。
1-3 hours
活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。
fresh
明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。
clear
前提条件
Python virtual environmentbasic command line
初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。
85
調査方針
Examine the existing documentation build setup in the repository, likely in the docs/ directory. Look for files like Makefile, conf.py, or requirements.txt to understand the build process. Write a step by step guide covering virtual environment creation, dependency installation, and building the site. Consider adding the instructions to docs/README.md or a CONTRIBUTING.md file. Ensure the guide is tested and includes any platform specific tips if necessary.