How to join OSGeo�for projects

Care and feeding of projects at OSGeo

www.osgeo.org

Florence - GeoServer code sprint 2017 (Jody Garnett)

How to join OSGeo�for project teams

Care and feeding of people at OSGeo

www.osgeo.org

Florence - GeoServer code sprint 2017 (Jody Garnett)

Welcome

Jody Garnett

jody.garnett@gmail.com

@jodygarnett@fosstodon.org

​

​

GeoCat

Software Development Company in Bennekom, the Netherlands. ��Focused on Spatial Data publication and discovery on the web following the free and open source source software philosophy.

Open Source Projects

• GeoServer, GeoTools, JTS, uDig

​

Open Source Geospatial Foundation

• Incubation Chair
• GeoTools Project Officer
• Marketing Committee�

Eclipse Foundation

• JTS Topology Suite
• ImageN

Open Source Geospatial Foundation

3

June 2023

Welcome

Tom Kralidis

​

tomkralidis@gmail.com

​

@tomkralidis

​

​

Open Source Projects

• pygeoapi
• pycsw
• QGIS (MetaSearch)
• OWSLib
• pygeometa
• GeoHealthCheck

​

Open Source Geospatial Foundation

• Board of Directors
• pygeoapi Project Officer
• Incubation Committee

​

Open Geospatial Consortium

• OGC API

​

World Meteorological Organization

• WIS 2.O
• data exchange
• metadata / discovery / search

​

Open Source Geospatial Foundation

4

June 2023

Empower everyone with open source geospatial�

• OSGeo is a not-for-profit software foundation
• Provides projects financial, organizational and legal support
• Outreach and advocacy
• Promoting global adoption of open source geospatial technology
• Partnerships on open approach to standards, data and education.
• OSGeo is a volunteer driven
• Passionate membership of individualsfrom around the world.

Open Source Geospatial Foundation

5

June 2023

Open Geospatial

• Working with our partners:
• Open Source: a collaborative approach to software development.
• Open Data: freely available information to use as you wish
• Open Standards: avoid lock-in with interoperable software
• Open Education: Removing the barriers to learning and teaching

Open Source Geospatial Foundation

6

June 2023

Software Foundation

• We are responsible for
• Supporting our great collection of projects
• Fostering new talent and innovation.

• OSGeo supports projects
• Technically with community of their peers
• Socially with community building and outreach
• Professionally ensuring each project is governed in a fair and sustainable manner

​

​

Open Source Geospatial Foundation

7

June 2023

Add to Website

Level 1 - Promotion

Open Source Geospatial Foundation

8

June 2023

Outreach and advocacy

• Marketing Committee
• Communication
• Handouts
• Branding
• Local chapters
• Regional promotion
• one-on-one advocacy
• GeoForAll
• Research and Academic

• Incubation Committee
• Projects List
• Choose-a-project

Open Source Geospatial Foundation

9

June 2023

Project List

• Directory of open source goodness!
• Keep in mind
• Foundation wants to promote�open source geospatial!
• Not only OSGeo projects

​

Open Source Geospatial Foundation

10

June 2023

Choose-a-project

Don’t know where to start?

​

Guided “wizard”:

• Enthusiast
• Mapping
• Processing
• GIS Professional
• Cartography
• Analysis
• IT Professionals
• Development

Open Source Geospatial Foundation

11

June 2023

Add to Website

We ask projects to:

• Geospatial
• Open Source
• Participatory

​

Open Source Geospatial Foundation

12

June 2023

Add to Website

Are you Geospatial?

• Mapping or Location Technology
• Examples
• Mapping and Cartography
• Location based
• Drones
• Indoor mapping
• Counter examples
• Community mapping website
• Open Software as a Service

We ask projects to:

• Geospatial

Open Source Geospatial Foundation

13

June 2023

Add to Website

Are you Free or Open Source?

​

Use an open source initiative approved license!

• Examples
• GPL, AGPL - Free
• BSD, Apache License - Open
• Counter examples
• End-user License Agreement
• Education & Research License

We ask projects to:

• Geospatial
• Open Source

​

​

​

Reference:

• https://opensource.org

Open Source Geospatial Foundation

14

June 2023

Add to Website

Can you play nice with others?

​

• Examples
• Pull-requests
• Issue tracker

​

• Counter examples
• Must work for the company
• Pay to review pull-request

We ask projects to:

• Geospatial
• Open Source
• Participatory

​

​

​

Open Source Geospatial Foundation

15

June 2023

How to: Add to Website

Please ask!

• Email to incubation list
• Introductions, discussion
• Review
• README.md
• LICENSE.md
• CONTRIBUTING.md
• Approved with +1�(any committee member)

​

​

And then make a project page

• Create an OSGeo UserID
• osgeo.org/osgeo_userid
• Sign into website
• Ask for “project author” role
• Create a project page
• Remember outreach focus!
• Email incubation list
• Review and publish!

Open Source Geospatial Foundation

16

June 2023

Add to Website

What we check

We ask projects to:

• Geospatial
• README
• Open Source
• LICENSE
• Participatory
• CONTRIBUTING

Open Source Geospatial Foundation

17

June 2023

Project�Name

We show what is important

• Project Identity

​

​

​

​

Outreach

• Brand awareness

Open Source Geospatial Foundation

18

June 2023

Project�Team

We show what is important

• Open source is about community
• Show the team!
• Important to project sustainability
• Recognize the people!

​

​

Outreach

• “Open source is full of people”

Open Source Geospatial Foundation

19

June 2023

Project Technology

We show what is important

• Assist evaluating technology
• screen-shot!
• core features
• standards

​

Outreach:

• focus on public, what we provided
• we believe in open standards

Open Source Geospatial Foundation

20

June 2023

Empower�Choice

We show what is important

• Open source alternatives
• Migrate to open source

​

​

Outreach

• Open-source gives you choice!

Open Source Geospatial Foundation

21

June 2023

ArcGIS Online® is a trademarks of Esri in the United States, the European Community, or certain other jurisdictions. Other companies and products mentioned may be trademarks of their respective owners.

Project�Communication

We show what is important

• Website
• Demo
• Download

​

​

Outreach:

• Help public make contact
• Transparent communication

Open Source Geospatial Foundation

22

June 2023

Project�Participation

We show what is important

• Issue trackers
• Source code
• License

​

​

​

​

Outreach:

• Enable open source re-mix culutre

Open Source Geospatial Foundation

23

June 2023

Commercial Support

We show what is important

• Service providers�(employ community members)

​

​

​

Outreach

• “Open source is supported”
• Link to service providers
• Promote sustainability
• Show core-contributors�(that take part in our community)

Open Source Geospatial Foundation

24

June 2023

OSGeo Website

We ask projects to:

• Geospatial
• README
• Open Source
• LICENSE
• Participatory
• CONTRIBUTING
• CODE_OF_CONDUCT

25

June 2023

OSGeo Community

Level 2 – Supporting

Open Source Geospatial Foundation

26

June 2023

OSGeo Community

• Support geospatial open source project
• Marketing and outreach
• Community and Events
• Code sprints
• Infrastructure
• Budget via OSGeo board

​

• Support innovation in our geospatial community
• Collaborate on ideas and opportunities

Open Source Geospatial Foundation

27

June 2023

OSGeo Community

We ask that community projects be:

• Geospatial
• Open Source
• Participatory

​

Recognized as part of OSGeo

• Public recognition with use of “OSGeo Community” logo
• Access to OSGeo infrastructure and marketing committee
• Take part of OSGeo annual budget�(making request via board)

Open Source Geospatial Foundation

28

June 2023

OSGeo Community

Are you Geospatial?

• Mapping or Location Technology
• Take it up a level
• User documentation?
• Website?
• gis-stack exchange?
• IRC, gitter, slack?

We ask that community projects be:

• Geospatial
• Open Source
• Participatory
• Code of Conduct

​

​

​

Open Source Geospatial Foundation

29

June 2023

OSGeo Community

Are you Open Source?

• OSI Approved License
• Take it up a level
• Check file headers

We ask that community projects be:

• Geospatial
• Open Source
• Participatory
• Code of Conduct

​

​

​

Open Source Geospatial Foundation

30

June 2023

OSGeo Community

Are you Open Source?

• Open to contributors
• Take it up a level:
• Show collaboration!
• Pull requests, patches?
• Issue tracker?
• OSGeo Live?

We ask that community projects be:

• Geospatial
• Open Source
• Participatory
• Code of Conduct

Open Source Geospatial Foundation

31

June 2023

How to: Community Project

Community Project Application

• Email to incubation list
• Introductions, discussion
• Review
• README.md
• User documentation
• LICENSE.md
• Headers
• CONTRIBUTING.md
• pull requests, patches
• CODE_OF_CONDUCT.md

​

​

Recommendation to Board

• Motion made to accept
• two weeks for voting
• OSGeo board is notified
• board meets monthly
• Done
• cross link websites
• osgeo community badge

​

​

​

Open Source Geospatial Foundation

32

June 2023

OSGeo Community

What we check

We ask projects to:

• Geospatial
• README
• User documentation
• Open Source
• LICENSE
• Headers
• Participa
• CONTRIBUTING
• pull requests, patches
• Code of Conduct
• contributor covenant

33

June 2023

OSGeo Community

What we check

We ask projects to:

• Geospatial
• README
• User documentation
• Open Source
• LICENSE
• Headers
• Participa
• CONTRIBUTING
• pull requests, patchest
• Code of Conduct
• contributor covenant

34

June 2023

OSGeo Community

What we check

We ask projects to:

• Geospatial
• README
• User documentation
• Open Source
• LICENSE
• Headers
• Participa
• CONTRIBUTING
• pull requests, patchest
• Code of Conduct
• contributor covenant

35

June 2023

OSGeo Community

What we check

We ask projects to:

• Geospatial
• README
• User documentation
• Open Source
• LICENSE
• Headers
• Participa
• CONTRIBUTING
• pull requests, patchest
• Code of Conduct
• contributor covenant

36

June 2023

OSGeo Project

Level 3 – Foundation

Open Source Geospatial Foundation

37

June 2023

OSGeo Project

• A full OSGeo committee
• Project “officer” for the team!
• Start initiatives, coordinate fundraising
• Set OSGeo Annual Budget
• Help set the annual budget
• Budget provides team operating independence�

• Responsible for
• Report to OSGeo Board
• Annual General Meeting Report

Open Source Geospatial Foundation

38

June 2023

OSGeo Projects

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

Open Source Geospatial Foundation

39

June 2023

OSGeo Projects

• Is your project open?
• Open source license
• Open communication channels
• Open decision making
• Examples:
• OSI Approved License
• Email, stack exchange, IRC, Gitter
• Project steering committee
• Why?
• Open source enables shared development
• Empower feeling of being included and ownership

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

40

June 2023

OSGeo Projects

• Active / healthy community?
• community of developers and users
• actively collaborate and support each other
• In a healthy way
• Examples:
• Collaboration on issue tracker and testing
• User participation in testing release candidates
• Why? “Social contract”
• shares maintenance risk
• devs release early release often
• users responsible for “testing” making software more stable and cheaper to developer

​

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

41

June 2023

OSGeo Projects

• Long term viability?

​

• Examples:
• Multiple developers
• Multiple organizations�(different sources of funding)
• Why?
• open source procurement
• Low “bus factor” metric

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

42

June 2023

OSGeo Projects

• Can you publish as open source?
• Code is open source license
• Did everyone actually agree?
• Really did you check?
• Examples:
• Code Providence Review
• List of all contributors w/ Agreement
• Why
• This is what it takes for�responsible open source
• “herd immunity”

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

43

June 2023

OSGeo Projects

• Can you publish as open source?
• Documentation uses an �open document license
• Examples:
• Creative Commons
• Why
• “Citation is not open”
• Grant writers the same re-mix freedoms we enjoy in open source

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

44

June 2023

OSGeo Projects

• Development process
• code under source control
• Issue tracker
• Examples
• git, svn
• trac, github, jira
• Why
• Good software development

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

45

June 2023

OSGeo Projects

• Fair development process
• “open governance”
• public decision making
• Examples
• Developers Guide or Wiki
• “Request for Proposal” (RFC)
• Why
• Welcome new developers
• Invite others to take part in a fair manner!

​

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

46

June 2023

OSGeo Projects

• User documentation
• Sufficient detail to perform core functionality of app
• Examples
• Quickstart
• User guide
• Why
• Friendly to new users
• Avoid open source,�closed training

​

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

47

June 2023

OSGeo Projects

• Developer documentation
• Checkout and build
• API Documentation
• Examples
• Javadocs for Java
• Sphinx for Python
• Why
• Friendly to new developers
• Enough detail for experienced developer to contribute fix

​

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

48

June 2023

OSGeo Projects

• Release guide
• Defined release procedure
• Documented testing process
• Examples
• Test before stable release
• Automated / Manual testing
• Test coverage goals
• Why
• Release early release often
• Enough detail to support new developers taking part

OSGeo projects demonstrate:

• Technical improvements, user documentation, documenting their release process.
• Social growth showing collaboration with users, an open community with clear transparent communication
• Fair governance clearly documenting how contributors can take part with leadership drawn from a number of organizations for sustainability

​

Open Source Geospatial Foundation

49

June 2023

How to: OSGeo Project

Application for Incubation

• Add to website
• Community Project
• Incubation application
• create a ticket
• email incubation list
• Find a mentor
• Start with incubation list
• This can take time (sigh)

Incubation with Mentor

• Go over checklist
• Clarifications with mentor
• Work on needed items
• Example providence review
• Mentor provided for private/sensitive/security discussions with team
• Graduation
• Mentor makes motion
• Incubation committee review
• Committee voting
• Chair recommends to board

Open Source Geospatial Foundation

50

June 2023

Graduation Checklist

• What OSGeo is looking for
• You can probably check off most of this already!
• Be careful
• Teams get “inspired”�(and do too much!)
• Be creative
• It says “user list” but if you use stack exchange it meets the same goal!

Open Source Geospatial Foundation

51

June 2023

Providence Review

• Beyond checking headers
• License compatibility
• Check history

Open Source Geospatial Foundation

52

June 2023

Case studies

pycsw

pygeoapi

Open Source Geospatial Foundation

53

June 2023

pycsw

Incubation period (~23 months)

• Entered: 2013-03-30
• Graduated: 2015-03-05
• Mentor: Jeff McKenna

​

​

​

​

​

​

​

https://github.com/geopython/pycsw/wiki/OSGeo-Incubation

​

Open Source Geospatial Foundation

54

June 2023

pycsw

• Issue tracking (label=OSGeo Incubation), wiki) to track and summarize
• Contribution Agreements
• Provenance Review
• Scripts
• Documenting everything!
• User docs
• Release packaging
• Release plans
• Roadmap
• Technical Infrastructure
• Managing contributions
• Healthy governance
• Not a set and forget exercise
• Benefit of packaging / distros / OSGeoLive

​

​

​

​

​

​

​

Open Source Geospatial Foundation

55

June 2023

pycsw

• Key resource: “Producing Open Source Software” by Karl Fogel
• Technical
• Social/Political
• Community
• Contributions

​

​

• https://producingoss.com

​

​

​

Open Source Geospatial Foundation

56

June 2023

pycsw

• Challenges / Learning experiences
• Measuring community
• What counts, what doesn’t, how to summarize
• Mailing list vs. chats
• Standalone application vs. downstream applications

​

​

​

​

​

​

​

Open Source Geospatial Foundation

57

June 2023

pygeoapi

Incubation period (~10 months)

• Entered: 2021-10-05
• Graduated: 2022-08-21!
• Mentor: Michael Smith

​

​

​

​

​

​

​

https://github.com/geopython/pygeoapi/wiki/OSGeoIncubation

​

Open Source Geospatial Foundation

58

June 2023

pygeoapi

• Key resource: “Producing Open Source Software” by Karl Fogel
• Technical
• Social/Political
• Community
• Contributions

​

• https://producingoss.com

Open Source Geospatial Foundation

59

June 2023

pygeoapi

• Used pycsw as a blueprint to success
• Existence of more tooling to help with tracking / summary / metrics
• GitHub Insights
• Many criteria already “in place” on project inception
• Source code headers
• Copyright
• Ecosystem of documentation
• Scripts
• Healthy governance

Open Source Geospatial Foundation

60

June 2023

pygeoapi

• Challenges / Learning experiences
• Balancing process and due diligence with innovation, rapidly growing codebase and community

​

​

​

​

​

​

Open Source Geospatial Foundation

61

June 2023

May the Source�Be with you

From your friends at

Open Source Geospatial Foundation

62

GeoServer Code Sprint 2017 (Jody Garnett)