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-04-03 12:20:29	Alex Sadleir	3
		4	# How to register and submit your entry
		5	## registering your team
2013-03-01 01:11:15	Maxious	6	how to use website "Hacker Space" to register and find teams etc.
2013-03-06 04:05:46	Maxious	7
2013-03-24 05:01:56	Alex Sadleir	8	## preparing your submission
		9
2013-03-01 01:11:15	Maxious	10	record a 3 minute speech and mix images/text to accompany
2013-03-24 05:01:56	Alex Sadleir	11	http://www.screenr.com/ and other screencasting tools allow you to demo apps.
2013-03-07 22:18:14	Maxious	12	youtube video editor http://www.youtube.com/editor
2013-03-21 11:02:25	Maxious	13	or local software like http://www.videolan.org/vlmc/ or http://www.lwks.com/
2013-03-07 22:18:14	Maxious	14
2013-03-21 11:02:25	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.
2013-03-07 22:18:14	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.
2013-03-21 11:02:25	Maxious	17
2013-03-07 22:18:14	Maxious	18
2013-03-06 04:05:46	Maxious	19	# General References {#general-data-hacking-and-programming-references}
		20
		21	## Who can be a hack day participant
2013-03-07 22:18:14	Maxious	22	- roles; coder, designer UX/graphics
2013-03-01 01:11:15	Maxious	23
		24	## Definitions
2013-03-03 10:00:40	maxious	25	- definitions, open licence reuse permissive hacker hack data journalism data vis UX etc.
2013-03-01 01:11:15	Maxious	26
2013-03-07 22:18:14	Maxious	27	## The basics of being a data scientist
		28
2013-03-01 01:11:15	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.
2013-03-24 05:01:56	Alex Sadleir	30	* 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	31	* Analyse and present results - were they what you expected? Do they help explain to others what you have found out?
		32	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-03 10:00:40	maxious	33
2013-03-01 01:11:15	Maxious	34
		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
2013-04-03 12:20:29	Alex Sadleir	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
		45	practical advice check out Data Analysis with Open Source Tools by Philipp K. Janert
2013-03-01 01:11:15	Maxious	46
		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/)
2013-04-03 12:20:29	Alex Sadleir	50
2013-03-01 01:11:15	Maxious	51
2013-04-03 12:20:29	Alex Sadleir	52	Statistics
2013-03-01 01:11:15	Maxious	53
		54	[http://greenteapress.com/thinkstats/html/index.html](http://greenteapress.com/thinkstats/html/index.html)
		55
2013-04-03 12:20:29	Alex Sadleir	56	Programming
2013-03-01 01:11:15	Maxious	57
		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
2013-03-24 05:01:56	Alex Sadleir	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/)
2013-03-01 01:11:15	Maxious	62
2013-03-03 10:00:40	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
2013-04-03 12:20:29	Alex Sadleir	64
2013-03-01 01:11:15	Maxious	65	Accessibility/User Experience
2013-03-24 05:01:56	Alex Sadleir	66
2013-03-01 01:11:15	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/)
2013-04-11 23:34:16	Maxious	68
		69
2013-03-01 01:11:15	Maxious	70
2013-04-11 23:34:16	Maxious	71	## examples
		72
2013-03-01 01:11:15	Maxious	73	## The Open Budget
		74
2013-04-03 12:20:29	Alex Sadleir	75	## WeatherTree weather API
2013-03-01 01:11:15	Maxious	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.
		80
2013-03-01 03:43:59	Maxious	81	Programming Language: Ruby
		82
2013-04-03 12:20:29	Alex Sadleir	83	Source Control: [Git](https://github.com/openaustralia/planningalerts-app)
2013-03-01 03:43:59	Maxious	84
		85	Issue Tracking: [Atlassian JIRA](http://tickets.openaustraliafoundation.org.au/browse/PA/)
2013-04-03 12:20:29	Alex Sadleir	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
		99	## Bus.lambdacomplex.org
		100
2013-03-24 05:01:56	Alex Sadleir	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.
2012-09-29 13:05:38	Maxious	104
		105	Programing Language: PHP/Ruby
2013-03-03 10:00:40	maxious	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/
		118	- bootstrap themes, web fonts, css sprites, icon fonts
		119	- http://designmodo.com/flat-free/ http://designmodo.github.com/Flat-UI/
2013-03-07 22:18:14	Maxious	120
		121	- http://ubuntu-tutorials.com/2008/11/11/relaying-postfix-smtp-via-smtpgmailcom/
2013-04-05 12:04:13	Maxious	122	- amon
2013-04-01 08:05:26	Alex Sadleir	123
2013-04-05 12:04:13	Maxious	124	### Source Control
		125	Git / Subversion
2013-04-11 12:42:26	maxious	126
2013-04-05 12:04:13	Maxious	127	[![](http://www.govhack.org/wp-content/uploads/Screenshot-at-2012-04-29-172132-300x235.png "Git Screenshot")](http://progit.org/book/)
		128
2013-04-01 08:05:26	Alex Sadleir	129	[http://progit.org/book/](http://progit.org/book/)
2013-03-01 01:11:15	Maxious	130
2013-04-01 08:05:26	Alex Sadleir	131	[http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
2013-03-24 05:01:56	Alex Sadleir	132
2012-09-29 13:05:38	Maxious	133	[http://tortoisesvn.net/](http://tortoisesvn.net/)
		134
2013-03-24 05:01:56	Alex Sadleir	135	[http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
2013-02-27 10:12:02	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
2013-03-03 10:00:40	maxious	141	[Trello](https://trello.com/) and [Workflowy](https://workflowy.com/) are free, lightweight project management tools suitable for a rapid project!
		142
		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
2013-03-01 01:11:15	Maxious	147	### Github
		148	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-01 04:32:26	Maxious	149
		150	### Sourceforge
		151
2013-04-11 12:42:26	maxious	152	Subversion, Git, Mercurial, Bazaar, CVS, issue tracker, wiki, release file downloads. Unlimited free use for open source projects.
2013-03-01 04:32:26	Maxious	153
		154	You can create your own Sourceforge project at [http://sourceforge.net/](http://sourceforge.net/)
2013-04-03 12:20:29	Alex