OSGeoLive Incubation Checklist

This page addresses the status of OSGeoLive as per version 2.0 of the ​OSGeo Incubation Checklist. It is derived from the ​Project Graduation Checklist

For the purposes of incubation auditing, the scope of the OSGeoLive project comprises of the scripts and processes used to build OSGeoLive, but doesn't include the specific projects being packages (many of which are addressing OSGeo Incubation separately in their own right).

Incubation Checklist

Open

The project has demonstrated that it has an open, active and healthy user and developer community:

• Open: projects are expected to function in an open and public manner and include:
  • Open source license(s),
  • YES: Code is under LGPL, Documentation under Creative Commons, as per ​https://github.com/OSGeo/OSGeoLive/blob/master/LICENSE.txt (for source code) and ​http://live.osgeo.org/en/copyright.html (for documentation)

• Open communication channels,
  • YES: We have an active email list, and hold weekly IRC meetings during build cycles. ​https://wiki.osgeo.org/wiki/OSGeoLive#Contact_Us
  • Open decision making process,
    • YES: Decision making process is documented at ​https://trac.osgeo.org/osgeolive/wiki/OSGeoLive%20PSC

• Active and healthy community:
  • The project should have a community of developers and users who actively collaborate and support each other in a healthy way. Eg. collaboration on project activities such as testing, release and feature development.
    • YES: A few hundred people have contributed to OSGeoLive. Most contributions have been in writing application installer scripts, associated documentation, as well as translations. A list of contributors are at: ​http://live.osgeo.org/en/sponsors.html
  • Long term viability of the project is demonstrated by showing participation and direction from multiple developers, who come from multiple organizations. Eg. The project is resilient enough to sustain loss of a developer or supporting organisation, often referred to as having a high ​bus factor. Decisions are made openly instead of behind closed doors, which empowers all developers to take ownership of the project and facilitates spreading of knowledge between current and future team members.
    • YES: Contributors come from a wide range of organizations (as seen by email addresses of contributors). Sponsoring organizations are also listed at: ​http://live.osgeo.org/en/sponsors.html

Copyright and License

We need to ensure that the project owns or otherwise has obtained the ability to release the project code by completing the following steps:

• All project source code is available under an Open Source license
  • YES: Code is under LGPL, as per ​https://github.com/OSGeo/OSGeoLive/blob/master/LICENSE.txt

• Project documentation is available under an open license, such as Creative Commons.
  • YES: Documentation is under Creative Commons license, as per ​http://live.osgeo.org/en/copyright.html

• The project code, documentation and data has been adequately vetted to assure it is all properly licensed, and a copyright notice included, as per a [​http://www.osgeo.org/incubator/process/codereview.html Provenance Review.
  • YES: We have performed a Provenance Review for our source code and documentation, available at ​https://trac.osgeo.org/osgeolive/wiki/Provenance%20Review

• The project maintains a list of all copyright holders identified in the Provenance Review Document.
  • YES: All contributors are listed at: ​http://live.osgeo.org/en/sponsors.html

• All code contributors have agreed to abide by the project's license policy, and this agreement has been documented and archived.
  • YES: All contributors have publicly accepted the terms of the OSGeoLive license. This is archived in the ​OSGeoLive email list and in the ​GitHub Pull Request history. The process is described here: ​https://trac.osgeo.org/osgeolive/wiki/Source_code#Commitaccess

Processes

• The project has code under configuration management. (Eg, subversion, git.)
  • YES: ​https://github.com/OSGeo/OSGeoLive and ​https://git.osgeo.org/gitea/osgeolive/OSGeoLive

• The project uses an issue tracker and keeps the status of the issue tracker up to date.
  • YES: ​https://wiki.osgeo.org/wiki/OSGeoLive#Issue_Tracker and a report on open issues ​https://trac.osgeo.org/osgeolive/report/10

• The project has documented its management processes. This is typically done within a Developers Guide or Project Management Plan.
  • YES: ​https://wiki.osgeo.org/wiki/OSGeoLive

• The project has a suitable open governance policy ensuring decisions are made, documented and adhered to in a public manner. This typically means a Project Management Committee has been established with a process for adding new members. A robust Project Management Committee will typically draw upon developers, users and key stakeholders from multiple organizations as there will be a greater variety of technical visions and the project is more resilient to a sponsor leaving.
  • Yes, Project Management Committee and management processes are defined at: ​https://trac.osgeo.org/osgeolive/wiki/OSGeoLive%20PSC

• The project uses public communication channels for decision making to maintain transparency. E.g. archived email list(s), archived IRC channel(s), public issue tracker.
  • YES: ​https://wiki.osgeo.org/wiki/OSGeoLive#Contact_Us

Documentation

• The project has user documentation:
  • Including sufficient detail to guide a new user through performing the core functionality provided by the application.
    • YES: The project has extensive Project Overviews and Quickstarts, specifically designed for getting new users up and running quickly. These are linked from: ​http://live.osgeo.org/en/index.html and ​http://live.osgeo.org/en/overview/overview.html

• The project has developer documentation:
  • YES: How to add a new project to OSGeoLive is covered in detail. Linked from: ​https://wiki.osgeo.org/wiki/OSGeoLive#How_to_add_a_project_to_OSGeoLive
  • Including checkout and build instructions.
    • YES: Linked from: ​https://wiki.osgeo.org/wiki/OSGeoLive#How_to_add_a_project_to_OSGeoLive
  • Including commented code, ideally published for developer use. (Examples: javadocs for Java applications, or Sphinx documentation for Python applications.)
    • YES: Code is primarily relatively small shell script files, which include comments.
  • Providing sufficient detail for an experience programmer to contribute patches or a new module in accordance with the project's programming conventions.
    • YES: We accept Pull Requests on GitHub and Gitea ​https://trac.osgeo.org/osgeolive/wiki/Source_code

Release Procedure

In order to maintain a consistent level of quality, the project should follow defined release and testing processes.

• The project follows a defined release process:
  • Which includes execution of the testing process before releasing a stable release.
  • The project has an established build and release process, but it needs to be more clearly documented. Some information here: ​https://wiki.osgeo.org/wiki/OSGeoLive_Build . The release management role is well established, but not documented. This includes setting up a schedule, sending out press releases, chasing up projects, etc, etc.

• The project follows a documented testing process. (Ideally, this includes both automated and manual testing)(Ideally this includes documented conformance to set quality goals, such as reporting Percentage Code Coverage of Unit Tests.)
  • OSGeoLive is an integration project, which is difficult to create automated testing for. Instead we rely on manual testing. The testing process is well practiced, and documented on OSGeoLive Testing Process

• Release and testing processes provide sufficient detail for an experienced programmer to follow.
  • OSGeoLive Testing Process