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