Skip to content

Commit

Permalink
updating readme
Browse files Browse the repository at this point in the history
  • Loading branch information
kapil1garg committed Apr 8, 2022
1 parent ed8b8a4 commit 58537c8
Showing 1 changed file with 18 additions and 3 deletions.
21 changes: 18 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,12 +18,27 @@ This tool helps us make these two groups by:

The tool does this by computing all near-even partitions and identifies candidate partitions that fully respects Pair Research matches and project teams. Then, partitions are scored and sorted based on: (1) how well partitions maintain LIP groupings; (2) how equal in size partitions are; and (3) how equal the number of PhD students between partitions is. _Note: to fully respect Pair Research matchings and project teams, we must allow for unequal group sizes; for example, if there are 10 students paired, then groups could have 4/6 people instead of 5/5._

## Setup
Simply clone the repo and open `hq.html`in your browser; no need to install any libraries or start a server. To host, include `css/`, `js/` and `hq.html` on your server.

## Usage
1. Click "add all teams" to add all project teams.
2. Type in individual pairings into the first text box, and add them by clicking "add pair research pairing". **All students present in DTR during class must be added, including those not paired or not doing Pair Research. Otherwise, they will not appear in the generated groups.**
3. Type in all students working on the same LIP into the second text box, and add them by clicking "add LIP group".
4. If needed during steps 3 and 4, click the "X" next to the Pairing, Team, or LIP Grouping to remove it (for instance, if a project team is not in DTR one week).
5. Click "Make Groups" to generate two Groups for LIP and Pair Research (this may take a couple seconds). Group A will always be the larger of the two groups if groups are not equal in size.

## Setup
1. Make sure you have [Node.js](https://nodejs.org/en/) and [yarn](https://classic.yarnpkg.com/en/docs/install#mac-stable) installed.
2. Create a `.env` file as follows:
```
NODE_ENV=development
PORT=3000
```
## Development
1. Run `yarn` to download the necessary packages.
2. Run `yarn run dev` to start the local Node.js application.
## Deployment
For production, use the following environment variables:
```
NODE_ENV=production
PORT=8080
```

0 comments on commit 58537c8

Please sign in to comment.