put sections into divs
[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}
20
21 ## Who can be a hack day participant
Maxious 22 - roles; coder, designer UX/graphics
Maxious 23
Maxious 24 ## Definitions
25 - definitions, open licence reuse permissive hacker hack data journalism data vis UX etc.
maxious 26
Maxious 27 ## The basics of being a data scientist
Maxious 28
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.
Maxious 30 * Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
Alex Sadleir 31 * Analyse and present results - were they what you expected? Do they help explain to others what you have found out?
Maxious 32 Can present as a interactive data visualisation or a web/mobile application or just a infographic/motion graphics video that tells a story.
33
maxious 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>
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
Alex Sadleir 44
45 practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
46
Maxious 47 For further reading in this space
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
Alex Sadleir 51
Maxious 52 **Statistics**
Alex Sadleir 53
Maxious 54 [http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
55
56 **Programming**
Alex Sadleir 57
Maxious 58 Programming is valuable skill for manipulating and displaying data.
59 Basic tutorials for a variety of languages are available for free online or you can learn
60
Alex Sadleir 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/)
62
Maxious 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
Alex Sadleir 65 **Accessibility/User Experience**
Maxious 66
Alex Sadleir 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/)
Maxious 68
Maxious 69
70
Maxious 71 ## examples
72
Alex Sadleir 73 ## The Open Budget
Maxious 74
75 ## WeatherTree weather API
76
77 ## PlanningAlerts
78
Maxious 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.
80
Alex Sadleir 81 Programming Language: Ruby
Maxious 82
83 Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
Alex Sadleir 84
85 Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
86
87 ## LobbyLens
88
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
Alex Sadleir 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)
Maxious 102
103 Description: Online Canberra Bus Timetables and Trip Planner.
maxious 104
105 Programing Language: PHP/Ruby
106
107 Source Control: Git
108
109 Issue Tracking: Github
110
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/
Maxious 118 - bootstrap themes, web fonts, css sprites, icon fonts
119 - http://designmodo.com/flat-free/ http://designmodo.github.com/Flat-UI/
Maxious 120
Alex Sadleir 121 - http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
Maxious 122 - amon
Alex Sadleir 123
maxious 124 ### Source Control
Maxious 125 Git / Subversion
Alex Sadleir 126
Maxious 127 [![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
128
Alex Sadleir 129 [http://progit.org/book/](http://progit.org/book/)
Alex Sadleir 130
131 [http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
132
133 [http://tortoisesvn.net/](http://tortoisesvn.net/)
134
maxious 135 [http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
136
Maxious 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
141 [Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
142
Alex Sadleir 143 ## Hosted Developer Tools {#hosted-developer-tools}
Maxious 144
Maxious 145 Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
Alex Sadleir 146
Maxious 147 ### Github
Alex Sadleir 148 Git obviously but svn/hg interfaces are possible. Provide their own GUI for Windows/OSX or use the variety of Git capable tools
maxious 149
150 ### Sourceforge
Maxious 151
152 Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
maxious 153