editz master
[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 ## registering your team
Maxious 6 how to use website "Hacker Space" to register and find teams etc.
Maxious 7
Alex Sadleir 8 ## preparing your submission
9
Maxious 10 record a 3 minute speech and mix images/text to accompany
Alex Sadleir 11 http://www.screenr.com/ and other screencasting tools allow you to demo apps.
Maxious 12 youtube video editor http://www.youtube.com/editor
Maxious 13 or local software like http://www.videolan.org/vlmc/ or http://www.lwks.com/
Maxious 14
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.
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.
Maxious 17
Maxious 18
Maxious 19 # General References {#general-data-hacking-and-programming-references}
Maxious 20
21 ## Who can be a hack day participant
Alex Sadleir 22 - roles; coder, designer UX/graphics
Maxious 23
Maxious 24 ## Definitions
Maxious 25 - definitions, open licence reuse permissive hacker hack data journalism data vis UX etc.
26
maxious 27 ## The basics of being a data scientist
Maxious 28
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.
Maxious 31 * Analyse and present results - were they what you expected? Do they help explain to others what you have found out?
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.
Maxious 33
34
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>
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
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
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
Alex Sadleir 52 **Statistics**
Maxious 53
Alex Sadleir 54 [http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
Maxious 55
56 **Programming**
57
Alex Sadleir 58 Programming is valuable skill for manipulating and displaying data.
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/)
Alex Sadleir 62
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
Maxious 64
maxious 65 **Accessibility/User Experience**
Alex Sadleir 66
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/)
Alex Sadleir 68
Maxious 69
Maxious 70
Maxious 71 ## examples
Maxious 72
73 ## The Open Budget
Alex Sadleir 74
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.
Maxious 80
81 Programming Language: Ruby
Maxious 82
83 Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
Maxious 84
Alex Sadleir 85 Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
Maxious 86
Alex Sadleir 87 ## LobbyLens
Maxious 88
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
Alex Sadleir 105 Programing Language: PHP/Ruby
Alex Sadleir 106
107 Source Control: Git
Alex Sadleir 108
Maxious 109 Issue Tracking: Github
110
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
Maxious 124 ### Source Control
125 Git / Subversion
Maxious 126
Alex Sadleir 127 [![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
Maxious 128
Alex Sadleir 129 [http://progit.org/book/](http://progit.org/book/)
maxious 130
Maxious 131 [http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
Alex Sadleir 132
Maxious 133 [http://tortoisesvn.net/](http://tortoisesvn.net/)
134
Alex Sadleir 135 [http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
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
maxious 141 [Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
142
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
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
Maxious