gitphp 0.2.9.1 :: tools.git/blame

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-03-24 05:01:56	Alex Sadleir	3
		4	# How to register and submit your entry
2013-03-01 01:11:15	Maxious	5	- how to use website "Hacker Space" to register and find teams etc.
2013-03-06 04:05:46	Maxious	6
2013-03-24 05:01:56	Alex Sadleir	7	- screencast tools - preparing your submission
		8	video tools, youtube video editor/slideshow, FOSS video editing tools
2013-03-01 01:11:15	Maxious	9
2013-03-24 05:01:56	Alex Sadleir	10	- how to submit code
2013-03-07 22:18:14	Maxious	11
2013-03-21 11:02:25	Maxious	12	# General References {#general-data-hacking-and-programming-references}
2013-03-07 22:18:14	Maxious	13	## The basics of being a data scientist
2013-03-21 11:02:25	Maxious	14
2013-03-07 22:18: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.
2013-03-21 11:02:25	Maxious	16	* Find the people and tools you need to prove/show/find. This rest of this page will help with the latter.
2013-03-07 22:18:14	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.
2013-03-06 04:05:46	Maxious	18	Please note, there are a combination of Analysis and Visualisation tools in each of the major categories below.
		19
		20
2013-03-07 22:18:14	Maxious	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>
		22	Illustration from Data Journalism Handbook, CC BY-SA 3.0</dd>
2013-04-01 08:05:26	Alex Sadleir	23
2013-03-07 22:18:14	Maxious	24
2013-03-01 01:11:15	Maxious	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
		26
2013-03-03 10:00:40	maxious	27	[datajournalismhandbook.org](http://datajournalismhandbook.org/)
2013-03-01 01:11:15	Maxious	28
2013-03-07 22:18:14	Maxious	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
		30
2013-03-01 01:11:15	Maxious	31	practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
2013-03-24 05:01:56	Alex Sadleir	32
2013-03-01 01:11:15	Maxious	33	For further reading in this space
		34
2013-03-03 10:00:40	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/)
2013-03-01 01:11:15	Maxious	36
		37
		38	Statistics
		39
		40	[http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
		41
		42	Programming
		43
		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
		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
		51
2013-03-03 10:00:40	maxious	52	Accessibility/User Experience
2013-03-01 01:11:15	Maxious	53
2013-03-03 10:00:40	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/)
2013-03-01 01:11:15	Maxious	55
		56	## Who can be a hack day participant
		57	- roles; coder, designer UX/graphics
		58
		59	## Definitions
		60	- definitions, open licence reuse permissive hacker hack data journalism data bis UCX etc.
		61
2013-03-24 05:01:56	Alex Sadleir	62	## key datasets
		63	- key datasets, directory.gov.au gazetter/AEC electorates/suburbs/postcodes/LGAs
2013-03-01 01:11:15	Maxious	64
2013-03-03 10:00:40	maxious	65	## examples
		66
2013-03-01 01:11:15	Maxious	67	## The Open Budget
2013-03-24 05:01:56	Alex Sadleir	68
2013-03-01 01:11:15	Maxious	69	## WeatherTree weather API
		70
		71	## PlanningAlerts
		72
		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.
		74
		75	Programming Language: Ruby
		76
		77	Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
		78
		79	Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
		80
		81	## LobbyLens
		82
		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)
2013-03-01 03:43:59	Maxious	84
		85	Description: Displays connections between government contracts, business details, politician responsibilities, lobbyists, clients of lobbyists, political donors and the location of these entities.
		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
		102
2013-03-24 05:01:56	Alex Sadleir	103	Issue Tracking: Github
		104
		105
2012-09-29 13:05:38	Maxious	106	## Developer Tools For Your Computer {#developer-tools-for-your-computer}
		107
2013-03-03 10:00:40	maxious	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/)
2013-03-07 22:18:14	Maxious	122
		123	[http://progit.org/book/](http://progit.org/book/)
2013-04-01 08:05:26	Alex Sadleir	124
		125	[http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
		126
2013-02-28 04:29:45	Maxious	127	[http://tortoisesvn.net/](http://tortoisesvn.net/)
2013-03-30 07:15:22	maxious	128
		129	[http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
2013-04-01 08:05:26	Alex Sadleir	130
2013-03-01 01:11:15	Maxious	131	### Task Tracking -
2013-04-01 08:05:26	Alex Sadleir	132
2013-03-24 05:01:56	Alex Sadleir	133	Issue/task trackers allow you to outline the tasks required for your project and assign them to people to do.
2012-09-29 13:05:38	Maxious	134
		135	[Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
2013-03-24 05:01:56	Alex Sadleir	136
2013-02-27 10:12:02	Alex Sadleir	137	## Hosted Developer Tools {#hosted-developer-tools}
		138
		139	Can get many tools (source control, issue tracking) combined into one service cloud hosted so no setup required.
		140
		141	### Github
2013-03-03 10:00:40	maxious	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
		146	Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
		147
2013-03-01 01:11:15	Maxious	148	You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
		149
2013-03-01 04:32:26	Maxious	150	### Google Code Project Hosting
		151
		152	Git, Mercurial, and Subversion code. Issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
		153
		154	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/)
2013-03-24 05:01:56	Alex Sadleir	155
		156
2013-03-01 04:32:26	Maxious	157
		158	# API Development {#api-development}
2013-03-24 05:01:56	Alex Sadleir	159
2013-03-30 07:15:22	maxious	160
		161	So an API isn't just an XML file ![;)](http://www.govhack.org/wp-includes/images/smilies/icon_wink.gif)
		162
2013-03-24 05:01:56	Alex Sadleir	163	A good web based data API:
		164
		165	* Is logically organised
		166	* Can filter returned data