Esri open source projects on GitHub

  • 669 views
Uploaded on

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.

More in: Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
    Be the first to like this
No Downloads

Views

Total Views
669
On Slideshare
0
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
13
Comments
0
Likes
0

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain

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