From ba88605f8e5ca9083767d0ddffcd2971806d6245 Mon Sep 17 00:00:00 2001 From: BoYanZh <bomingzh@sjtu.edu.cn> Date: Wed, 13 Oct 2021 02:58:50 +0800 Subject: [PATCH] docs: very simple doc --- README.md | 8 ++++---- docs/index.md | 29 +++++++++++++++++++++++++++-- 2 files changed, 31 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index c347dea..eeb21d5 100644 --- a/README.md +++ b/README.md @@ -7,15 +7,15 @@ A handy tool for TAs in JI to handle works through [Gitea](https://focs.ji.sjtu. ### Setup venv (Optional) ```bash -python3 -m venv env -source env/Scripts/activate +python3 -m venv env # you only need to do that once +source env/Scripts/activate # each time when you need this venv ``` -### Install & Run +### Install ```bash pip3 install -e . -vi .env # configure environment +cp .env.exmaple .env && vi .env # configure environment joint-teapot --help ``` diff --git a/docs/index.md b/docs/index.md index cc0b5ff..83e9d79 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,3 +1,28 @@ -# Welcome +# Joint Teapot -In progress... +A handy tool for TAs in JI to handle works through [Gitea](https://focs.ji.sjtu.edu.cn/git/), [Canvas](https://umjicanvas.com/), and [JOJ](https://joj.sjtu.edu.cn/). Joint is related to JI and also this tool which join websites together. Teapot means to hold Gitea, inspired by [@nichujie](https://github.com/nichujie). + +## Getting Started + +### Setup venv (Optional) + +```bash +python3 -m venv env # you only need to do that once +source env/Scripts/activate # each time when you need this venv +``` + +### Install + +```bash +pip3 install -e . +cp .env.exmaple .env && vi .env # configure environment +joint-teapot --help +``` + +### For developers + +```bash +pip3 install -r requirements-dev.txt +pre-commit install +pytest -svv +```