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

1. Esri Open Source
Projects on GitHub
Allan Laframboise
alaframboise.github.com
@AL_Laframboise

3. GitHub
Little Background

4. What is GitHub?
§ Cloud-based
platform for building, collaborating
and managing open source projects
§ Built
on Git
§ 4+
million projects
§ 1+
million developers

5. Why Git/GitHub?
§ DVCS
§ Full
(Distributed Version Control System)
copy distribution
§ Branching,
§ Strong
merging, issues, wiki
community

6. “pull request”

7. GitHub and Open Source
§ Freely
§ Access
§ Use
§ Contribute
§ Distribute
GitHub is a vehicle; a very popular one.

8. 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

9. What can you publish?
§ Typical
§ Other
§ Code
§ City
§ Documents
§ Slide
presentations
§ Website content
§ GeoJSON
data
§ Travel logs
§ Music
§ Recipes
§ Blogs/Campaigns
§ Legal docs
§ Government…

10. github.com

11. Esri on GitHub
Open Source Projects

12. Esri Organization
github.com/esri

13. Esri Organization
esri.github.com

14. Esri Projects

15. Project Types
1.
2.
Products
Apps and Samples
4.
Templates and Frameworks
Geo Tools
5.
Industry and Government
3.

16. ArcGIS Products
arcgis-flex-viewer
arcgis-flex-viewer-builder
arcgis-osm-editor
arcgis-dijit-geocoder-js

17. Apps and Samples
quickstart-map-js
maps-app-android
sencha-touch-map-checkin-js
driving-directions-ios
arcgis-samples-winstore

18. Templates and Frameworks
bootstrap-map-js
basic-storytelling-template-js
social-media-map-template-js
3d-cities-template
spatial-framework-for-hadoop

19. Geo Tools
esri-leaflet
Terraformer
geoportal-server
gis-tools-for-hadoop
geometry-api-java
node-geoservices-adaptor/koop
geoservices-js

20. Industry and Government
my-government-services
executive-dashboard
park-and-recreation-finder
citizen-service-request
water-utility-network-editing

21. Project Activity
§ 450+
developers
§ 140+ projects

22. github.com/esri
esri.github.com

23. GitHub Workflow
Getting Started

24. 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

25. help.github.com

26. You will do one of the following:
1)
Get (steal) Code
2)
Contribute Code
3)
Create a New Project

27. 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 ---

28. The first thing
you’ll do…

29. 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!

30. 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”!

31. 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!

32. The second thing
you’ll do…

33. 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!

34. The third thing
you’ll do…

35. 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!

36. If you’re cool,
you’ll also…

37. 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!

38. README.md
§ Description
§ Features
§ Instructions
§ Requirements
§ Resources
§ Issues
§ Contributing
§ Licensing

39. alaframboise.github.com

40. 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

41. esri.github.com