Factoid
A Factoid is a short, high-level bullet point delivering a simple observation about a Project. Factoids are derived from an Analysis, and new Factoids are created for a Project every time a new Analysis is created.
On the Ohloh web site, Factoids are rendered in the Nutshell section of the project summary page. Factoids also are available in several of the sharing widgets available for embedding on websites.
A Project has factoids only if Ohloh has downloaded and analyzed its source code.
Properties
id
The unique ID for the Factoid. Factoid IDs change every time the Project is reanalyzed, so it’s unwise to store these IDs for long periods.
analysis_id
The unique ID of the analysis used to calculate this factoid.
type
The Factoid type. The possible types are defined below.
description
A short, human-readable description. This is the bullet point text which appears on the Ohloh project page.
severity
An integer from -3 to +3 which rates the relative severity of the factoid. Negative numbers generally indicate bad news, positive numbers generally indicate good news. Ohloh uses these numbers to select icons to display beside the factoids. All factoids of the same type have the save severity.
URL
To get a single Factoid:
GET http://www.ohloh.net/projects/{project_id}/factoids/{factoid_id}.xml Collection URL
To get a list of all current Factoids for a particular Project:
GET http://www.ohloh.net/projects/{project_id}/factoids.xml The collection request does not support any filtering, sorting or paging. You will always receive the entire collection of factoids, ordered by descending priority.
Factoid Types
FactoidActivityDecreasing
During the last twelve calendar months, there were at least 25% fewer commits to this project than in the prior twelve calendar months.
FactoidActivityStable
During the last twelve calendar months, the commit count was within +/- 25% of the count for the prior twelve calendar months.
FactoidActivityIncreasing
During the last twelve calendar months, there were at least 25% more commits to this project than in the prior twelve calendar months.
FactoidAgeYoung
The source control repository is less than 1 year old.
FactoidAgeEstablished
The source control repository is 1 to 3 years old.
FactoidAgeOld
The source control repository is 3 to 5 years old.
FactoidAgeVeryOld
The source control repository is 5 years old or older.
FactoidCommentsVeryLow
Compared to all other projects written in the same language, the comment ratio for this project is in the bottom 10%.
FactoidCommentsLow
Compared to all other projects written in the same language, the comment ratio for this project is in the bottom 33% but not in the bottom 10%.
FactoidCommentsAverage
Compared to all other projects written in the same language, the comment ratio for this project is in the middle 33%.
FactoidCommentsHigh
Compared to all other projects written in the same language, the comment ratio for this project is in the top 33% but not in the top 10%.
FactoidCommentsVeryHigh
Compared to all other projects written in the same language, the comment ratio for this project is in the top 10%.
FactoidTeamSizeZero
No commits were made to this project in the last 12 months.
FactoidTeamSizeOne
Only a single contributor made commits to this project in the last 12 months.
FactoidTeamSizeSmall
Two or three contributors made commits to this project in the last 12 months.
FactoidTeamSizeAverage
4 to 6 contributors made commits to this project in the last 12 months.
FactoidTeamSizeLarge
7 to 27 contributors made commits to this project in the last 12 months.
FactoidTeamSizeVeryLarge
28 or more contributors made commits to this project in the last 12 months.
Mostly Written In…
The “…is mostly written in” bullet point listed in the Nutshell section of project summaries and in widgets displaying factoid information is not technically a factoid. This element is actually the main_language_name property on an analysis.
