OpenHub

Document Properties
Status: draft

Approved by: TODO

Overview
The Black Duck Open Hub (formerly Ohloh.net) is an online community and public directory of free and open source software (FOSS), offering analytics and search services for discovering, evaluating, tracking, and comparing open source code and projects.

Purpose
The purpose of this page is to provide roles and responsibilities, rules of engagement, and process identification for OSGeo usage of Open Hub.

Scope
OSGeo Open Hub applies to all FOSS4G projects (OSGeo projects, incubating, labs, or other FOSS4G projects).

Open Hub Basics
The basic workflows of Open Hub are as follows:


 * FOSS projects register their project / codebase / repository
 * Open Hub analyzes project codebase(s)
 * Open Hub provides analytics, comparisons and metrics about projects, users and organizations
 * user activity/presence
 * project performance (LOC, commits, contributors, etc.)
 * organizational performance (affiliated members, portfolio of projects)

The following relationships exist on Open Hub:


 * users can affiliate themselves with a given organization
 * organizations can claim a given project

Open Hub is a free service.

Example Entities on Open Hub

 * project: https://www.openhub.net/p/gnome
 * user account: https://www.openhub.net/accounts/odvarko
 * organization: https://www.openhub.net/orgs/openstack

OSGeo Implementation

 * OSGeo maintains an organizational presence on OpenHub.
 * the OSGeo Live project provides summary metrics using Open Hub
 * TODO: others?

Administrative Privileges
The OSGeo organization on Open Hub is administered by 1..n managers. Organization managers have the ability to claim projects to be included within the organization.

Business Processes
The following sections articulate core processes around managing OSGeo's Open Hub presence. The processes should be reviewed on an annual basis (by Board?)

Administration Management
Managers of the OSGeo organization:


 * are chosen by trust principle
 * make their best effort to respond to user requests in a timely fashion within 7 business days.

OSGeo Issue Tracker
The OSGeo Issue Tracker shall be used as the means of tracking the lifecycle of requests relevant to OSGeo Open Hub management. A component called "Open Hub" shall be used to categorize/triage requests accordingly.

Claiming a Project
Claiming a project on Open Hub can happen in the following circumstances:


 * incubating projects
 * Labs projects
 * projects expressing interest in being part of OSGeo

Project requests to be claimed by OSGeo

 * project representative opens ticket on OSGeo Issue Tracker with Component=Open Hub
 * URL of project on Open Hub
 * OSGeo Open Hub manager are alerted via email
 * if required, discussion / consensus are documented in the issue
 * Open Hub managers add project to OSGeo organization
 * Issue is closed by project representative

OSGeo requests to claim project

 * OSGeo Open Hub manager opens ticket on OSGeo Issue Tracker with Component=Open Hub
 * URL of project on Open Hub
 * project representatives are alerted via email
 * if required, discussion / consensus are documented in the issue
 * OSGeo Open Hub manager add project to OSGeo organization
 * Issue is closed by OSGeo Open Hub manager

Removing a Project

 * OSGeo Open Hub manager OR project representative opens ticket on OSGeo Issues Tracker with Component=Open Hub
 * project representatives OR Open Hub Manager are alerted via email
 * if required, discussion / consensus are documented in the issue
 * OSGeo Open Hub manager removes project from OSGeo organization
 * Issue is closed by the same party who opened the issue