Esri open source projects on GitHub
Upcoming SlideShare
Loading in...5
×
 

Like this? Share it with your network

Share

Esri open source projects on GitHub

on

  • 1,021 views

A quick look at the projects that are out there and how to get started using GitHub.

A quick look at the projects that are out there and how to get started using GitHub.

Statistics

Views

Total Views
1,021
Views on SlideShare
1,021
Embed Views
0

Actions

Likes
0
Downloads
13
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment
  • AL Explain <br />
  • AL Explain <br />
  • AL Explain <br />
  • AL Explain <br />
  • AL Explain <br />
  • AL Explain <br />
  • AL Explain <br />

Esri open source projects on GitHub Presentation Transcript

  • 1. Esri Open Source Projects on GitHub Allan Laframboise alaframboise.github.com @AL_Laframboise
  • 2. GitHub Little Background
  • 3. What is GitHub? §  Cloud-based platform for building, collaborating and managing open source projects §  Built on Git §  4+ million projects §  1+ million developers
  • 4. Why Git/GitHub? §  DVCS §  Full (Distributed Version Control System) copy distribution §  Branching, §  Strong merging, issues, wiki community
  • 5. “pull request”
  • 6. GitHub and Open Source §  Freely §  Access §  Use §  Contribute §  Distribute GitHub is a vehicle; a very popular one.
  • 7. GitHub Components §  GitHub.com (in the cloud) §  Search, watch, star, notifications, issues, wiki, gist §  Dashboards - activity, repos, contributions… §  User accounts §  Organization §  GitHub Clients §  GitHub for Mac or Windows §  Git – command-line
  • 8. What can you publish? §  Typical §  Other §  Code §  City §  Documents §  Slide presentations §  Website content §  GeoJSON data §  Travel logs §  Music §  Recipes §  Blogs/Campaigns §  Legal docs §  Government…
  • 9. github.com
  • 10. Esri on GitHub Open Source Projects
  • 11. Esri Organization github.com/esri
  • 12. Esri Organization esri.github.com
  • 13. Esri Projects
  • 14. Project Types 1.  2.  Products Apps and Samples 4.  Templates and Frameworks Geo Tools 5.  Industry and Government 3. 
  • 15. ArcGIS Products arcgis-flex-viewer arcgis-flex-viewer-builder arcgis-osm-editor arcgis-dijit-geocoder-js
  • 16. Apps and Samples quickstart-map-js maps-app-android sencha-touch-map-checkin-js driving-directions-ios arcgis-samples-winstore
  • 17. Templates and Frameworks bootstrap-map-js basic-storytelling-template-js social-media-map-template-js 3d-cities-template spatial-framework-for-hadoop
  • 18. Geo Tools esri-leaflet Terraformer geoportal-server gis-tools-for-hadoop geometry-api-java node-geoservices-adaptor/koop geoservices-js
  • 19. Industry and Government my-government-services executive-dashboard park-and-recreation-finder citizen-service-request water-utility-network-editing
  • 20. Project Activity § 450+ developers § 140+ projects
  • 21. github.com/esri esri.github.com
  • 22. GitHub Workflow Getting Started
  • 23. Getting Started – Homework Assignment! 1.  Create a GitHub.com account 2.  Install a GitHub client (and Git) §  windows.github.com §  mac.github.com Resources §  Doc, videos, ref - git-scm.com §  Top Git Commands - gitref.org §  Markdown - daringfireball.net/projects/markdown/syntax §  Tutorial - http://try.github.com
  • 24. help.github.com
  • 25. You will do one of the following: 1)  Get (steal) Code 2)  Contribute Code 3)  Create a New Project
  • 26. GitHub Work-flow 1. Fork 1.  Fork 2.  Clone --- Local commits --3.  Pull/Merge 4.  Push 5.  Pull Request Upstream/ Master 5. Pull Request Your Fork 4. Push 2. Clone 3. Pull/ Merge Your Clone --- Local Commits ---
  • 27. The first thing you’ll do…
  • 28. Get Code 1. Fork §  Fork: Cloud copy §  Clone: Local copy Upstream/ Master 5. Pull Request Your Fork 4. Push 2. Clone 3. Pull/ Merge Your Clone $ git clone https://github.com/alaframboise/quickstart-mapjs.git!
  • 29. Make Local Commits 1. Fork §  Add changes to the index §  Store local edits Upstream/ Master 5. Pull Request Your Fork 4. Push 2. Clone 3. Pull/ Merge Your Clone --- Local Commits --- $ git add * ! $ git commit –m “These are my cool edits to code”!
  • 30. Merge and Push Code 1. Fork §  Create §  Pull remote connection and merge edits §  Push to your cloud Upstream/ Master 5. Pull Request Your Fork 4. Push 2. Clone 3. Pull/ Merge Your Clone Tip: Always merge before pushing $ git add remote upstream https://github.com/Esri/ quickstart-map-js.git! $ git pull upstream master! $ git push origin master!
  • 31. The second thing you’ll do…
  • 32. Pull Request 1. Fork §  Request to accept §  Specify branch §  Ensure can merge Upstream/ Master 5. Pull Request Your Fork 4. Push 2. Clone 3. Pull/ Merge Your Clone Tip: Use web client!
  • 33. The third thing you’ll do…
  • 34. New Project 1. Fork §  Create §  Publish §  Push §  Pull/Merge Upstream/ Master 5. Pull Request Your Fork Push 2. Clone Pull/ Merge Your Clone $ $ $ $ git git git git init (or create on GitHub and $git clone …)! add *! commit “My awesome project”! push master!
  • 35. If you’re cool, you’ll also…
  • 36. Publish Documentation 1. Fork §  README.md §  Use gh-pages §  Use wiki Upstream/ Master 5. Pull Request Your Fork Push 2. Clone Pull/ Merge Your Clone $ git checkout –b “gh-pages”! $ git push origin gh-pages!
  • 37. README.md §  Description §  Features §  Instructions §  Requirements §  Resources §  Issues §  Contributing §  Licensing
  • 38. alaframboise.github.com
  • 39. Final Notes §  Get on GitHub! §  Check §  Find out the esri.github.com a project §  Follow a project §  Create a project §  Make §  Join a pull request the community
  • 40. esri.github.com