edits
--- a/index.md
+++ b/index.md
@@ -19,9 +19,6 @@
# General References {#general-data-hacking-and-programming-references}
-
-## Who can be a hack day participant
-There are many roles you can play as a hack day participant; coder, designer UX/graphics.
## The basics of being a data scientist
@@ -68,13 +65,12 @@
[](http://progit.org/book/)
-[http://progit.org/book/](http://progit.org/book/)
-
-[http://svnbook.red-bean.com/](http://svnbook.red-bean.com/)
-
-[http://tortoisesvn.net/](http://tortoisesvn.net/)
-
-[http://code.google.com/p/tortoisegit/](http://code.google.com/p/tortoisegit/)
+[tutorials on git](http://progit.org/book/) and
+[GUIs to help you](http://code.google.com/p/tortoisegit/)
+
+[manual for Subversion](http://svnbook.red-bean.com/)
+and a [similar GUI for Subversion](http://tortoisesvn.net/)
+
### Task Tracking
@@ -123,11 +119,12 @@
Atlassian have a great page on what makes a good API https://developer.atlassian.com/display/REST/Atlassian+REST+API+Design+Guidelines+version+1)
-howto.gov api resources about choosing SOAP vs. REST etc. http://www.howto.gov/mobile/apis-in-government
-
-API documentation is important too.
- - WSDL or http://swagger.wordnik.com/ or https://github.com/mashery/iodocs
- - Many web app frameworks can generate the documentation for you. For example Symfony for PHPhttp://symfony.com/ https://github.com/FriendsOfSymfony/FOSRestBundle http://williamdurand.fr/2012/08/02/rest-apis-with-symfony2-the-right-way/ https://github.com/nelmio/NelmioApiDocBundle better apis https://github.com/liip/LiipHelloBundle
+HowTo.gov has a bunch of api resources about choosing SOAP vs. REST etc. http://www.howto.gov/mobile/apis-in-government
+
+API documentation is important too! Traditionally for SOAP APIs, you use WSDL but for REST try [Swagger](http://swagger.wordnik.com/) or [iodocs](https://github.com/mashery/iodocs)
+Many web app frameworks can generate the documentation for you. For example Symfony for PHP http://symfony.com/ https://github.com/FriendsOfSymfony/FOSRestBundle http://williamdurand.fr/2012/08/02/rest-apis-with-symfony2-the-right-way/ https://github.com/nelmio/NelmioApiDocBundle
+
+ better apis https://github.com/liip/LiipHelloBundle
- or for Rails https://github.com/elc/rapi_doc https://github.com/Pajk/apipie-rails
http://amberonrails.com/building-stripes-api/
@@ -237,7 +234,7 @@
- http://converter.mygeodata.eu/vector kml exporter for shp
or locally using GDAL
-### geocoding
+### Geocoding
cloudmade, google (but you must display on a Google Map).
Easiest way to do is with a Google Spreadsheet/Fusion Table http://williamparry.blogspot.com.au/2011/04/putting-data-into-google-fusion-tables.htm http://support.google.com/fusiontables/answer/1012281?hl=en&ref_topic=2592806
@@ -324,7 +321,7 @@
- http://chartsnthings.tumblr.com/post/36978271916/r-tutorial-simple-charts http://flowingdata.com/2012/12/17/getting-started-with-charts-in-r/
http://www.r-bloggers.com/to-plot-them-is-my-real-test/
-
+ http://blog.revolutionanalytics.com/2013/04/visualize-large-data-sets-with-the-bigvis-package.html 10 Million Points in 5 seconds.
## Visualisation
@@ -332,9 +329,10 @@
Create visualisations from various data formats by dragging and dropping. Free trial available on website. [](img/Tableau-Screenshot.jpg)
-### [Flotr2](http://www.humblesoftware.com/flotr2/)/[Google Chart Tools](https://developers.google.com/chart/)
-
+### Web page (Javascript) graphs
+[Flotr2](http://www.humblesoftware.com/flotr2/)/[Google Chart Tools](https://developers.google.com/chart/)
[](img/How-to-participate-in-GovHack_html_m11006fce.jpg)Javascript based charts for webpages.
+http://www.polychartjs.com/ Allows facetting and easy use of JSON data sets.
### D3.js (Data-Driven Documents)
@@ -387,7 +385,7 @@
## Analysis
### R
-
+http://www.slideshare.net/ianmcook/social-network-analysis-in-r
- http://is-r.tumblr.com/post/38240018815/making-prettier-network-graphs-with-sna-and-igraph
@@ -398,11 +396,8 @@
- http://www.slideshare.net/maxdemarzi/etl-into-neo4j
http://blog.neo4j.org/2013/03/importing-data-into-neo4j-spreadsheet.html
-http://www.orientdb.org/
-
-http://thinkaurelius.github.com/titan/
-
-Major graph databases like theese can be accessed using a common tool like Gremlin or by writing a simple Java/Python/Ruby application. Queries can be tested in the built in data browser.
+There are other graph databases worth considering like [OrientDB](http://www.orientdb.org/) or [Titan](http://thinkaurelius.github.com/titan/)
+Major graph databases like these can be accessed using a common syntax called Gremlin or by writing a simple Java/Python/Ruby application. Queries can be tested in the built in data browser.
@@ -417,7 +412,7 @@
## Visualisation
### Tree/Hierarchy visualisation
-Sometimes what you actually have is a tree/hierarchy with no interconnections.
+Sometimes what you actually have is a tree/hierarchy with no interconnections. In these cases, it's better to use a Tree visualisation.
http://www.randelshofer.ch/treeviz/ http://thejit.org/demos/ http://mbostock.github.com/protovis/ex/treemap.html http://blog.pixelingene.com/2011/07/building-a-tree-diagram-in-d3-js/d3 for Trees and Hierarchies
http://mbostock.github.com/d3/ex/pack.html http://mbostock.github.com/d3/ex/tree.html