Skip to content

Commit 40d74f0

Browse files
update readme
1 parent f5eeca7 commit 40d74f0

File tree

1 file changed

+21
-36
lines changed

1 file changed

+21
-36
lines changed

README.md

+21-36
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,15 @@
1-
HELPq
2-
======
1+
# HELPq
32

43
An extensible, customizable real-time queue system, built with [Meteor](https://www.meteor.com/)!
54

65
![Home Screen](./.docs/images/screenshots/home.png)
76

8-
What is this?
9-
------------
7+
## What is this?
108

119
HELPq was originally built for [HackMIT](https://hackmit.org), but has been used at hackathons like [Blueprint](http://blueprint.hackmit.org), [Meteor Summer Hackathon 2015](http://meteorhack.meteor.com/), [WHACK](http://wellesleyhacks.org/), [MakeMIT](http://makemit.org/) and [WildHacks](http://wildhacks.org/) (among others!).
1210

1311
It is a real-time help queue and mentor management application, targeted at hackathons and classrooms, where there is a need for issues to be claimed and satisfied within minutes. It includes a simple interface for requesting tickets, claiming tickets, administrating users/mentors, and examining metrics.
1412

15-
1613
It is built with an emphasis on three fundamental user experiences:
1714

1815
### Keep it simple
@@ -27,8 +24,7 @@ Mentors should not receive any type of push notifications when tickets are reque
2724

2825
Mentors can claim tickets, complete tickets, or choose to reopen them. Mentors can only claim a single ticket at any given time. There is no ability to message a student through the app in order to encourage a mentor to find that student and help them in person. A student can, however, choose to include other contact information in case contact is needed to clarify location.
2926

30-
Features
31-
---------
27+
## Features
3228

3329
### Home
3430

@@ -60,7 +56,6 @@ Mentors should be mobile, and the HELPq is designed for mentors to browse the he
6056

6157
If a user is a mentor, they will have an inbox icon in the top right they can click to navigate to the mentor view. If the HELPq is being viewed on mobile or a very narrow window, the app is responsive and will pull up a navigation bar on the bottom for Home, Mentor, and Profile.
6258

63-
6459
#### Claim
6560

6661
You can claim a ticket by selecting "Claim Ticket". This will notify the user that you are on your way! Once a ticket is claimed, you cannot claim another ticket unless you complete or reopen the ticket.
@@ -122,36 +117,30 @@ The feedback section is a feed of all mentor feedback, with star rating and a no
122117

123118
Settings allows you to adjust various settings in the queue. Right now, you can open/close the queue and set the time for when tickets expire.
124119

125-
126-
Usage Data
127-
----------
120+
## Usage Data
128121

129122
We've used this at a bunch of hackathons and we have some data on them :)
130123

131-
| Hackathon | Date | Response time average | median | stddev | Completion Time average | median | stddev | Rating Average | Users | Mentors | Tickets|
132-
|-----------|------|-------------------|--------|---------|---------------------|--------|---------|------------|-------|---------|--------|
133-
|**Blueprint High School Hackathon 2015** | 2/22/2015 | 5:11 | 1:26 | 9:54 | 10:37 | 6:29 | 13:23 | 4.9 | 193 | 64 | 170 |
134-
|**Meteor Summer Hackathon 2015** | 8/8/2015 | 6:21 | 2:29 | 10:58 | 5:46 | 1:26 | 12:03 | 4.09 | 68 | 66| 37 |
135-
|**HackMIT 2015** | 9/19/2015 | 9:37 | 2:48 | 28:00 | 16:30 | 10:01 | 22:59 | 4.7 | 425 | 242 | 502 |
136-
|**WHACK 2015** | 10/3/2015 | 7:55 | 4:56 | 12:30 | 18:19 | 13:02 | 17:27 | 4.9 | 87 | 39 | 94 |
137-
|**HackIllinois**| 2/19/2016 | 56:00 | 8:47 | 3:00:29 | 32:53 | 18:46 | 1:00:25 | 4.6 | 353 | 353 | 221 |
124+
| Hackathon | Date | Response time average | median | stddev | Completion Time average | median | stddev | Rating Average | Users | Mentors | Tickets |
125+
| ---------------------------------------- | --------- | --------------------- | ------ | ------- | ----------------------- | ------ | ------- | -------------- | ----- | ------- | ------- |
126+
| **Blueprint High School Hackathon 2015** | 2/22/2015 | 5:11 | 1:26 | 9:54 | 10:37 | 6:29 | 13:23 | 4.9 | 193 | 64 | 170 |
127+
| **Meteor Summer Hackathon 2015** | 8/8/2015 | 6:21 | 2:29 | 10:58 | 5:46 | 1:26 | 12:03 | 4.09 | 68 | 66 | 37 |
128+
| **HackMIT 2015** | 9/19/2015 | 9:37 | 2:48 | 28:00 | 16:30 | 10:01 | 22:59 | 4.7 | 425 | 242 | 502 |
129+
| **WHACK 2015** | 10/3/2015 | 7:55 | 4:56 | 12:30 | 18:19 | 13:02 | 17:27 | 4.9 | 87 | 39 | 94 |
130+
| **HackIllinois** | 2/19/2016 | 56:00 | 8:47 | 3:00:29 | 32:53 | 18:46 | 1:00:25 | 4.6 | 353 | 353 | 221 |
138131

139-
Bring HELPq to your hackathon/classroom!
140-
========================================
132+
# Bring HELPq to your hackathon/classroom!
141133

142-
Requirements
143-
------------
134+
## Requirements
144135

145136
Make sure that you have `meteor` installed.
146137
You can install Meteor through their [website.](https://www.meteor.com/)
147138

148-
149-
Quickstart
150-
----------
139+
## Quickstart
151140

152141
#### Heroku
153142

154-
[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/ehzhang/HELPq/tree/master)
143+
[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/icdocsoc/HELPq/tree/master)
155144

156145
When deploying to Heroku, you **must** set at least the `ROOT_URL` and `ADMIN_PASSWORD` environment variables.
157146

@@ -170,8 +159,8 @@ Copy the `private/config.json.template` into `private/config.json`
170159
meteor
171160
```
172161

173-
Deploy
174-
------
162+
## Deploy
163+
175164
**IMPORTANT**
176165

177166
Without login configuration, you will only be able to login with the admin username and password specified in `private/config.json` (or the corresponding environment variables).
@@ -182,8 +171,7 @@ If you're not using Heroku, you can deploy with:
182171
meteor deploy <your domain name>.meteor.com
183172
```
184173

185-
Configuration
186-
-------------
174+
## Configuration
187175

188176
#### Login
189177

@@ -205,17 +193,14 @@ To edit copy, edit `lib/constants.js`.
205193

206194
In this file, you will find a place where you can change various strings across the site, including the title of your app.
207195

208-
Orientation
209-
-----------
196+
## Orientation
210197

211198
The queue has been found to be most effective with an orientation with mentors and a tight integration with the way a hackathon/classroom manages mentorship. If you'd like to talk about how this could work for your hackathon/classroom, don't hesitate to email me at [[email protected]](mailto:[email protected])!
212199

213-
Feedback
214-
--------
200+
## Feedback
215201

216202
Have you used HELPq or are planning to use it at your hackathon? I'd love to hear how effective it was, what kinds of metrics you got, and what kinds of things people wanted. Don't hesitate to email me at [[email protected]](mailto:[email protected])!
217203

218-
Contributing
219-
------------
204+
## Contributing
220205

221206
I'd love to take pull requests! Please read the [Contributing Guide](CONTRIBUTING.md) first!

0 commit comments

Comments
 (0)