Esri open source projects on GitHub

1,415 views
1,126 views

Published on

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

Published in: Technology
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
1,415
On SlideShare
0
From Embeds
0
Number of Embeds
1
Actions
Shares
0
Downloads
17
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • AL Explain
  • Esri open source projects on GitHub

    1. 1. Esri Open Source Projects on GitHub Allan Laframboise alaframboise.github.com @AL_Laframboise
    2. 2. GitHub Little Background
    3. 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. 4. Why Git/GitHub? §  DVCS §  Full (Distributed Version Control System) copy distribution §  Branching, §  Strong merging, issues, wiki community
    5. 5. “pull request”
    6. 6. GitHub and Open Source §  Freely §  Access §  Use §  Contribute §  Distribute GitHub is a vehicle; a very popular one.
    7. 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. 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. 9. github.com
    10. 10. Esri on GitHub Open Source Projects
    11. 11. Esri Organization github.com/esri
    12. 12. Esri Organization esri.github.com
    13. 13. Esri Projects
    14. 14. Project Types 1.  2.  Products Apps and Samples 4.  Templates and Frameworks Geo Tools 5.  Industry and Government 3. 
    15. 15. ArcGIS Products arcgis-flex-viewer arcgis-flex-viewer-builder arcgis-osm-editor arcgis-dijit-geocoder-js
    16. 16. Apps and Samples quickstart-map-js maps-app-android sencha-touch-map-checkin-js driving-directions-ios arcgis-samples-winstore
    17. 17. Templates and Frameworks bootstrap-map-js basic-storytelling-template-js social-media-map-template-js 3d-cities-template spatial-framework-for-hadoop
    18. 18. Geo Tools esri-leaflet Terraformer geoportal-server gis-tools-for-hadoop geometry-api-java node-geoservices-adaptor/koop geoservices-js
    19. 19. Industry and Government my-government-services executive-dashboard park-and-recreation-finder citizen-service-request water-utility-network-editing
    20. 20. Project Activity § 450+ developers § 140+ projects
    21. 21. github.com/esri esri.github.com
    22. 22. GitHub Workflow Getting Started
    23. 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. 24. help.github.com
    25. 25. You will do one of the following: 1)  Get (steal) Code 2)  Contribute Code 3)  Create a New Project
    26. 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. 27. The first thing you’ll do…
    28. 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. 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. 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. 31. The second thing you’ll do…
    32. 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. 33. The third thing you’ll do…
    34. 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. 35. If you’re cool, you’ll also…
    36. 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. 37. README.md §  Description §  Features §  Instructions §  Requirements §  Resources §  Issues §  Contributing §  Licensing
    38. 38. alaframboise.github.com
    39. 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. 40. esri.github.com

    ×