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
TODO 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
You should 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
To mix together clips, you can use youtube video editor http://www.youtube.com/editor or local software like http://www.videolan.org/vlmc/ or http://www.lwks.com/
2013-03-21 11:02:25
Maxious
13
2013-03-07 22:18:14
Maxious
14
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-03-21 11:02:25
Maxious
15
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
16
2013-03-21 11:02:25
Maxious
17
2013-03-07 22:18:14
Maxious
18
# General References {#general-data-hacking-and-programming-references}
2013-03-06 04:05:46
Maxious
19
20
## Who can be a hack day participant
2013-04-28 09:46:26
Alex Sadleir
21
- roles; coder, designer UX/graphics
2013-03-07 22:18:14
Maxious
22
2013-04-12 05:52:11
Maxious
23
## Definitions
2013-03-01 01:11:15
Maxious
24
- definitions, open licence reuse permissive hacker hack data journalism data vis UX etc.
25
2013-03-03 10:00:40
maxious
26
## The basics of being a data scientist
2013-03-01 01:11:15
Maxious
27
2013-03-07 22:18:14
Maxious
28
* 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.
29
* 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
30
* 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
31
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
32
33
2013-03-03 10:00:40
maxious
34
[![](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
35
Illustration from Data Journalism Handbook, CC BY-SA 3.0</dd>
36
37
38
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
39
40
[datajournalismhandbook.org](http://datajournalismhandbook.org/)
41
42
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
43
2013-04-03 12:20:29
Alex Sadleir
44
practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
45
46
For further reading in this space
2013-03-01 01:11:15
Maxious
47
48
[http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/](http://flowingdata.com/2012/04/27/data-and-visualization-blogs-worth-following/)
49
50
2013-04-03 12:20:29
Alex Sadleir
51
**Statistics**
2013-03-01 01:11:15
Maxious
52
2013-04-03 12:20:29
Alex Sadleir
53
[http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
2013-03-01 01:11:15
Maxious
54
55
**Programming**
56
2013-04-03 12:20:29
Alex Sadleir
57
Programming is valuable skill for manipulating and displaying data.
2013-03-01 01:11:15
Maxious
58
Basic tutorials for a variety of languages are available for free online or you can learn
59
60
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
61
2013-03-24 05:01:56
Alex Sadleir
62
[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
63
2013-03-03 10:00:40
maxious
64
**Accessibility/User Experience**
2013-04-03 12:20:29
Alex Sadleir
65
2013-03-01 01:11:15
Maxious
66
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
67
2013-03-01 01:11:15
Maxious
68
2013-05-01 23:17:16
Maxious
69
2013-04-15 04:13:09
Maxious
70
## examples
2013-03-01 01:11:15
Maxious
71
72
## The Open Budget
2013-04-03 12:20:29
Alex Sadleir
73
2013-03-01 01:11:15
Maxious
74
## WeatherTree weather API
75
76
## PlanningAlerts
77
78
[![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
79
80
Programming Language: Ruby
81
2013-04-28 09:46:26
Alex Sadleir
82
Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
2013-03-01 03:43:59
Maxious
83
2013-04-03 12:20:29
Alex Sadleir
84
Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
2013-03-01 03:43:59
Maxious
85
86
## LobbyLens
2013-04-03 12:20:29
Alex Sadleir
87
88
[![](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)
89
90
Description: Displays connections between government contracts, business details, politician responsibilities, lobbyists, clients of lobbyists, political donors and the location of these entities.
91
92
Programing Language: PHP
93
94
Source Control: SVN (Subversion)
95
96
Issue Tracking: A whiteboard
97
98
## bus.lambdacomplex.org
99
100
[![](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)
101
2013-03-24 05:01:56
Alex Sadleir
102
Description: Online Canberra Bus Timetables and Trip Planner.
103
2013-04-28 09:46:26
Alex Sadleir
104
Programing Language: PHP/Ruby
2012-09-29 13:05:38
Maxious
105
106
Source Control: Git
2013-04-28 09:46:26
Alex Sadleir
107
108
Issue Tracking: Github
109
110
111
## Developer Tools For Your Computer {#developer-tools-for-your-computer}
112
113
server admin / technical tools
114
many projects will require some kind of internet presence, webpage etc.
115
- css framework like bootstrap or zurb foundation
116
- css gauges http://www.larentis.eu/donuts/
117
- bootstrap themes, web fonts, css sprites, icon fonts
118
- http://designmodo.com/flat-free/ http://designmodo.github.com/Flat-UI/
119
120
- http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
2013-03-07 22:18:14
Maxious
121
- amon
122
2013-04-05 12:04:13
Maxious
123
### Source Control
2013-04-01 08:05:26
Alex Sadleir
124
Git / Subversion
2013-04-05 12:04:13
Maxious
125
2013-04-20 01:29:05
Alex Sadleir
126
[![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
2013-04-11 12:42:26
maxious
127
2013-04-05 12:04:13
Maxious
128
[http://progit.org/book/](http://progit.org/book/)
2013-04-20 01:29:05
Alex Sadleir
129
2012-09-29 13:05:38
Maxious
130
[http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
131
2013-04-28 09:46:26
Alex Sadleir
132
[http://tortoisesvn.net/](http://tortoisesvn.net/)
2013-02-27 10:12:02
Alex Sadleir
133
134
[http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
135
136
### Task Tracking -
137
2013-03-03 10:00:40
maxious
138
Issue/task trackers allow you to outline the tasks required for your project and assign them to people to do.
139
2013-04-12 05:52:11
Maxious
140
[Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
141
142
## Hosted Developer Tools {#hosted-developer-tools}
143
144
Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
2013-05-01 23:17:16
Maxious
145
146
### Github
2013-03-01 04:32:26
Maxious
147
Git obviously but svn/hg interfaces are possible. Provide their own GUI for Windows/OSX or use the variety of Git capable tools
2013-04-12 05:52:11
Maxious
148
2013-03-24 05:01:56
Alex Sadleir
149
### Sourceforge
2013-03-01 04:32:26
Maxious
150