2013-03-24 05:01:56
Alex Sadleir
1
Welcome to the GovHack toolkit. This page provides all the information you need to prepare hackfest entries.
2013-03-01 01:11:15
Maxious
2
These tools can be used to make entries like: mobile apps, web apps, data visualisations/infographics
2013-04-03 12:20:29
Alex Sadleir
3
4
# How to register and submit your entry
5
## registering your team
2013-03-01 01:11:15
Maxious
6
how to use website "Hacker Space" to register and find teams etc.
2013-03-06 04:05:46
Maxious
7
2013-03-24 05:01:56
Alex Sadleir
8
## preparing your submission
9
2013-03-01 01:11:15
Maxious
10
record a 3 minute speech and mix images/text to accompany
2013-03-24 05:01:56
Alex Sadleir
11
http://www.screenr.com/ and other screencasting tools allow you to demo apps.
2013-03-07 22:18:14
Maxious
12
youtube video editor http://www.youtube.com/editor
2013-03-21 11:02:25
Maxious
13
or local software like http://www.videolan.org/vlmc/ or http://www.lwks.com/
2013-05-07 23:32:34
Maxious
14
2013-03-21 11:02:25
Maxious
15
you also need to submit your "source material". For an application this may be source code, for another work it might be your notes or prototypes.
2013-05-24 01:28:05
Maxious
16
The key thing here is that your source material demonstrates to the judges that some of the end result was your own work and that it is possible for another person to replicate that work.
2013-03-07 22:18:14
Maxious
17
2013-03-21 11:02:25
Maxious
18
2013-03-07 22:18:14
Maxious
19
# General References {#general-data-hacking-and-programming-references}
2013-03-06 04:05:46
Maxious
20
21
## Who can be a hack day participant
2013-04-28 09:46:26
Alex Sadleir
22
- roles; coder, designer UX/graphics
2013-03-07 22:18:14
Maxious
23
2013-04-12 05:52:11
Maxious
24
## Definitions
2013-03-01 01:11:15
Maxious
25
- definitions, open licence reuse permissive hacker hack data journalism data vis UX etc.
26
2013-03-03 10:00:40
maxious
27
## The basics of being a data scientist
2013-03-01 01:11:15
Maxious
28
2013-03-07 22:18:14
Maxious
29
* Have a hypothesis - even if you're making a tool/api that helps people with their questions too, remember what the objective of that is.
30
* Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
2013-03-01 01:11:15
Maxious
31
* Analyse and present results - were they what you expected? Do they help explain to others what you have found out?
2013-03-24 05:01:56
Alex Sadleir
32
Can present as a interactive data visualisation or a web/mobile application or just a infographic/motion graphics video that tells a story.
2013-03-01 01:11:15
Maxious
33
34
2013-03-03 10:00:40
maxious
35
[![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f-300x199.gif "Data Journalism Diagram")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_m6a65720f.gif)</dt>
2013-03-01 01:11:15
Maxious
36
Illustration from Data Journalism Handbook, CC BY-SA 3.0</dd>
37
38
39
The best high level reference is the 'Understanding Data' and 'Delivering Data' chapters of the Data Journalism Handbook which is available online for free at
40
41
[datajournalismhandbook.org](http://datajournalismhandbook.org/)
42
43
You can learn the technical skills from scratch in Visualize This: The FlowingData Guide to Design, Visualization, and Statistics by Nathan Yau or for more advanced
44
2013-04-03 12:20:29
Alex Sadleir
45
practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
46
47
For further reading in this space
2013-03-01 01:11:15
Maxious
48
49
[http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/](http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/)
50
51
2013-04-03 12:20:29
Alex Sadleir
52
**Statistics**
2013-03-01 01:11:15
Maxious
53
2013-04-03 12:20:29
Alex Sadleir
54
[http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
2013-03-01 01:11:15
Maxious
55
56
**Programming**
57
2013-04-03 12:20:29
Alex Sadleir
58
Programming is valuable skill for manipulating and displaying data.
2013-03-01 01:11:15
Maxious
59
Basic tutorials for a variety of languages are available for free online or you can learn
60
61
interactively with websites like [http://www.codecademy.com/](http://www.codecademy.com/#!/exercises/0). for JavaScript or [http://www.learnpython.org/ ](http://www.learnpython.org/)or [http://tryruby.org](http://tryruby.org/)
2013-04-28 09:46:26
Alex Sadleir
62
2013-03-24 05:01:56
Alex Sadleir
63
[https://developer.mozilla.org/en/JavaScript](https://developer.mozilla.org/en/JavaScript) - especially for web applications and visualisations, you'll need a basic understanding of JS. Common libraries like prototype or jQuery can help
2013-03-01 01:11:15
Maxious
64
2013-03-03 10:00:40
maxious
65
**Accessibility/User Experience**
2013-04-03 12:20:29
Alex Sadleir
66
2013-03-01 01:11:15
Maxious
67
WCAG guidelines not only make a web app accessible but make it a better experience for all users! Even if not making an app, good to consider these things to do and not do: [http://www.w3.org/TR/WCAG/](http://www.w3.org/TR/WCAG/)
2013-03-24 05:01:56
Alex Sadleir
68
2013-03-01 01:11:15
Maxious
69
2013-05-07 23:32:34
Maxious
70
2013-04-15 04:13:09
Maxious
71
## examples
2013-03-01 01:11:15
Maxious
72
73
## The Open Budget
2013-04-03 12:20:29
Alex Sadleir
74
2013-03-01 01:11:15
Maxious
75
## WeatherTree weather API
76
77
## PlanningAlerts
78
79
[![Planning Alerts Screenshot](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1-300x221.png "Planning Alerts Screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_2f0199ff1.png)Description: Planning Alerts takes data from local government development applications and sends alerts to users based on what applications are lodged in their area.
2013-05-01 23:17:16
Maxious
80
81
Programming Language: Ruby
2013-05-24 01:28:05
Maxious
82
83
Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
2013-05-01 23:17:16
Maxious
84
2013-04-28 09:46:26
Alex Sadleir
85
Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
2013-03-01 03:43:59
Maxious
86
2013-04-03 12:20:29
Alex Sadleir
87
## LobbyLens
2013-03-01 03:43:59
Maxious
88
2013-05-07 23:32:34
Maxious
89
[![](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium-300x180.png "LobbyLens screenshot")](http://www.govhack.org/wp-content/uploads/129-Screenshot-LobbyClue_-_Chromium.png)
90
91
Description: Displays connections between government contracts, business details, politician responsibilities, lobbyists, clients of lobbyists, political donors and the location of these entities.
92
93
Programing Language: PHP
94
95
Source Control: SVN (Subversion)
96
97
Issue Tracking: A whiteboard
98
99
## Bus.lambdacomplex.org
100
101
[![](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae-300x253.jpg "Bus.lambda screenshot")](http://www.govhack.org/wp-content/uploads/How-to-participate-in-GovHack_html_3789acae.jpg)
102
103
Description: Online Canberra Bus Timetables and Trip Planner.
104
2013-04-03 12:20:29
Alex Sadleir
105
Programing Language: PHP/Ruby
2013-03-24 05:01:56
Alex Sadleir
106
107
Source Control: Git
2013-04-28 09:46:26
Alex Sadleir
108
2012-09-29 13:05:38
Maxious
109
Issue Tracking: Github
110
2013-04-28 09:46:26
Alex Sadleir
111
112
## Developer Tools For Your Computer {#developer-tools-for-your-computer}
113
114
server admin / technical tools
115
many projects will require some kind of internet presence, webpage etc.
116
- css framework like bootstrap or zurb foundation
117
- css gauges http://www.larentis.eu/donuts/
118
- bootstrap themes, web fonts, css sprites, icon fonts
119
- http://designmodo.com/flat-free/ http://designmodo.github.com/Flat-UI/
120
121
- http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
122
- amon
123
2013-03-07 22:18:14
Maxious
124
### Source Control
125
Git / Subversion
2013-04-05 12:04:13
Maxious
126
2013-04-01 08:05:26
Alex Sadleir
127
[![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
2013-04-05 12:04:13
Maxious
128
2013-04-20 01:29:05
Alex Sadleir
129
[http://progit.org/book/](http://progit.org/book/)
2013-04-11 12:42:26
maxious
130
2013-04-05 12:04:13
Maxious
131
[http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
2013-04-20 01:29:05
Alex Sadleir
132
2012-09-29 13:05:38
Maxious
133
[http://tortoisesvn.net/](http://tortoisesvn.net/)
134
2013-04-28 09:46:26
Alex Sadleir
135
[http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
2013-02-27 10:12:02
Alex Sadleir
136
137
### Task Tracking -
138
139
Issue/task trackers allow you to outline the tasks required for your project and assign them to people to do.
140
2013-03-03 10:00:40
maxious
141
[Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
142
2013-04-12 05:52:11
Maxious
143
## Hosted Developer Tools {#hosted-developer-tools}
144
145
Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
146
147
### Github
2013-05-01 23:17:16
Maxious
148
Git obviously but svn/hg interfaces are possible. Provide their own GUI for Windows/OSX or use the variety of Git capable tools
149
2013-03-01 04:32:26
Maxious