Your SlideShare is downloading. ×
0
Esri Open Source
Projects on GitHub
Allan Laframboise
alaframboise.github.com
@AL_Laframboise
GitHub
Little Background
What is GitHub?
§  Cloud-based

platform for building, collaborating
and managing open source projects

§  Built

on Git...
Why Git/GitHub?
§  DVCS
§  Full

(Distributed Version Control System)

copy distribution

§  Branching,
§  Strong

mer...
“pull request”
GitHub and Open Source
§  Freely
§  Access
§  Use
§  Contribute
§  Distribute

GitHub is a vehicle; a very popular on...
GitHub Components
§  GitHub.com

(in the cloud)

§  Search,

watch, star, notifications, issues, wiki, gist
§  Dashboar...
What can you publish?
§  Typical

§  Other

§  Code

§  City

§  Documents
§  Slide

presentations
§  Website conte...
github.com
Esri on GitHub
Open Source Projects
Esri Organization
github.com/esri
Esri Organization
esri.github.com
Esri Projects
Project Types

1. 
2. 

Products
Apps and Samples

4. 

Templates and Frameworks
Geo Tools

5. 

Industry and Government

...
ArcGIS Products
arcgis-flex-viewer
arcgis-flex-viewer-builder
arcgis-osm-editor
arcgis-dijit-geocoder-js
Apps and Samples
quickstart-map-js
maps-app-android
sencha-touch-map-checkin-js
driving-directions-ios
arcgis-samples-wins...
Templates and Frameworks
bootstrap-map-js
basic-storytelling-template-js
social-media-map-template-js
3d-cities-template
s...
Geo Tools
esri-leaflet
Terraformer
geoportal-server
gis-tools-for-hadoop
geometry-api-java
node-geoservices-adaptor/koop
g...
Industry and Government
my-government-services
executive-dashboard
park-and-recreation-finder
citizen-service-request
wate...
Project Activity
§ 450+

developers
§ 140+ projects
github.com/esri
esri.github.com
GitHub Workflow
Getting Started
Getting Started – Homework Assignment!
1. 

Create a GitHub.com account

2. 

Install a GitHub client (and Git)
§  window...
help.github.com
You will do one of the following:
1) 

Get (steal) Code

2) 

Contribute Code

3) 

Create a New Project
GitHub Work-flow
1. Fork

1. 

Fork

2. 

Clone

--- Local commits --3. 

Pull/Merge

4. 

Push

5. 

Pull Request

Upstre...
The first thing
you’ll do…
Get Code
1. Fork

§  Fork:

Cloud copy

§  Clone:

Local copy

Upstream/
Master

5. Pull Request
Your Fork

4. Push

2. ...
Make Local Commits
1. Fork

§  Add

changes to the index

§  Store

local edits

Upstream/
Master

5. Pull Request
Your ...
Merge and Push Code
1. Fork

§  Create
§  Pull

remote connection

and merge edits

§  Push

to your cloud

Upstream/
M...
The second thing
you’ll do…
Pull Request
1. Fork

§  Request

to accept

§  Specify

branch

§  Ensure

can merge

Upstream/
Master

5. Pull Reques...
The third thing
you’ll do…
New Project
1. Fork

§  Create
§  Publish
§  Push
§  Pull/Merge

Upstream/
Master

5. Pull Request
Your Fork

Push

2....
If you’re cool,
you’ll also…
Publish Documentation
1. Fork

§  README.md
§  Use

gh-pages

§  Use

wiki

Upstream/
Master

5. Pull Request
Your Fork...
README.md
§  Description
§  Features
§  Instructions
§  Requirements
§  Resources
§  Issues
§  Contributing
§  Lic...
alaframboise.github.com
Final Notes
§  Get

on GitHub!

§  Check
§  Find

out the esri.github.com

a project

§  Follow

a project

§  Create...
esri.github.com
Esri open source projects on GitHub
Esri open source projects on GitHub
Upcoming SlideShare
Loading in...5
×

Esri open source projects on GitHub

837

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
837
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
16
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
  • Transcript of "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
    1. A particular slide catching your eye?

      Clipping is a handy way to collect important slides you want to go back to later.

    ×