Skip to content

Commit 41084a7

Browse files
authored
Merge pull request #1 from nicholasday/update_readme
Update README
2 parents 704444d + a33413b commit 41084a7

File tree

1 file changed

+37
-2
lines changed

1 file changed

+37
-2
lines changed

README.md

+37-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,37 @@
1-
# automatic-judging-tool
2-
Scrapes devpost and generates csvs for teams for judging
1+
# DevGET
2+
3+
GETS submission data from [Devpost](https://devpost.com) Hackathons and generates CSVs for judging teams based on prize categories.
4+
5+
This is necessary because Devpost doesn't provide an API. We _may_ have manually
6+
scraped the data to provide it for our judges in previous years....
7+
8+
# Usage
9+
10+
Log in to Devpost, after installing the extension. Go to Account -> Manage Hackathons -> Submissions. Once you're on the submissions page, click the DevGET button. The results from the scraping should be in the console. (Soon to be downloadable and normalized in CSV files)
11+
12+
# Installation
13+
14+
1. Clone the repo
15+
16+
2. Peruse Chrome's extension [getting started tutorial](https://developer.chrome.com/extensions/getstarted) at your leisure
17+
* We will walk through the gist of it in the following steps
18+
19+
3. In Chrome, go to `chrome://extensions`
20+
21+
4. Toggle the `Developer Mode` switch on the page
22+
23+
5. Click `Load unpacked`
24+
25+
6. Select the directory of this repo that you cloned earlier
26+
27+
# Documentation
28+
29+
`get_submission_data.js` contains the code for parsing the Devpost page and
30+
downloading the subsequent html pages specific for each submission. It formats
31+
this data into an array of submissions and prizes for each submission.
32+
33+
`popup.js` handles the extension's button in the toolbar and executing
34+
`get_submission_data.js` once the button is clicked, and logging the results to the
35+
console.
36+
37+
`popup.html` specifies the button and it's design.

0 commit comments

Comments
 (0)