You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/usage.md
+17-11Lines changed: 17 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,25 +10,31 @@ For a printable version of this document see [📄 Handbook for hackathons power
10
10
11
11
**Dribdat** (from Driven by Data) works as an online multitool and project board, incorporating best practices from community building, such as templates for 🌳beginner 😄intermediate 🏀advanced level challenges, a 7-stage process for effective data-driven projects, connectivity to popular collaboration platforms, and time-tracking utilities.
12
12
13
-
So what are we waiting for? Let's get started!
13
+
So what are we waiting for? *Let's get started!*
14
14
15
15
## Quick start
16
16
17
-
Open the page of an event, log in and create a user **Profile**. Then you can explore the existing challenges at your event. Keep an eye on the unfilled Roles (🖍️Designer ⚙️Enabler 💡Facilitator etc.) that are shown on the bottom of the project page, if you are not sure which team you should support. You can then leave a **Comment** or **Join** the challenge.
17
+
Open the page of an event, log in and create a user **Profile**. Then you can explore the existing challenges at your event. Keep an eye on the unfilled Roles (🖍️Designer ⚙️Enabler 💡Facilitator etc.) that are shown on the bottom of the project page, if you are not sure which team you should support.
Before the event starts, you may also be able to submit a **New** challenge, along with a summary of your idea. This could be linked to a supported design tool or code repository. Once you have a project page, you and any of your team members can click the **Join** button to make changes and contribute updates.
21
+
When you open an upcoming event, you are shown a list of teams. The **Join event** button guides you with a shortlist (shown above) based on your profile data. 💡 We are working on new teambuilding features - [stay tuned!](https://hackintegration.ch)
22
22
23
-

23
+
When you open a team page, you can leave a **Comment** or **Join** the challenge.
You may also be able to submit a **New** challenge or start a team, along with a summary of your idea. This could be linked to a supported design tool or code repository, as detailed further down. Once you have a project page, you and any of your team members can click the **Join** button to make changes and contribute updates.
28
+
29
+

24
30
25
31
A typical Dribdat-powered event (this is from [GLAMhack](https://hack.glam.opendata.ch/) - the Swiss Open Culture Data hackathon) has a variety of challenges and projects at different stages, which you can explore in a hexagonal grid:
26
32
27
33

28
34
29
35
### Leap into action
30
36
31
-
Use your project page to document what makes your ideas tick. Post a creative 30-second **Pitch** using plain text or [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). There is an editor you can activate which helps you learn this widely used formatting style.
37
+
Use your project page to document what makes your ideas tick. Post a creative 30-second **Pitch** using plain text or [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). There is an editor you can activate which helps you learn this widely used formatting style.
32
38
33
39
Feeling hacky? Use the Pitch to write your presentation with a few simple statements and [Marpit Markdown](https://marpit.marp.app/markdown) formatting, then **✓ Enable slide mode**.
34
40
@@ -38,7 +44,7 @@ You can add links to sound or video clips, embed documents or a slideshow hosted
38
44
39
45
The picture below explains the various parts of a typical challenge or project page:
@@ -47,7 +53,7 @@ Some teams are content with just adding a link to their Demo or uploading their
47
53
48
54
**Edit** your project to add notes or answer questions relevant to the event you are at, and **Details** to tweak the Contact, Download, Source, Image links and more.
49
55
50
-

56
+

51
57
52
58
The **README** feature allows you to connect documentation from your open source repository on [GitHub](https://github.com), an online document at [Etherpad](http://etherpad.org), and many other collaboration platforms.
53
59
@@ -57,7 +63,7 @@ The **README** feature allows you to connect documentation from your open source
57
63
58
64
By updating your progress using the **Post** button, you can regularly check in your team's status or any roadblocks. You may see a couple of tips for completing or advancing your project at the top of the screen. You can find this button on the top of any projects you have joined, or on your profile page (which takes you to your latest team).
59
65
60
-

66
+

61
67
62
68
### Keep tabs on everyones progress
63
69
@@ -67,10 +73,10 @@ The posts are visible in the **Log** section of your project, in the **Dribs** g
67
73
68
74
Of course you can also cross-post to a variety of social networks to boost your online rep from here!
69
75
70
-

76
+

71
77
72
78
That's all there is to it, as a user. Read the [Organiser's guide](organiser) if you'd like to see more details about running your own event.
0 commit comments