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