Table of Contents

Interpreting the License Group Analysis Report

NOTE: this functionality is deprecated in release 1.2. In release 1.2 this functionality was replaced with buckets. Do not use this functionality as it will be removed in the next release (1.3).

License Group Description

The license heirarchy permits viewing individual licenses. However, it is common for individual licenses to fit into specific categories. For example, you may not care whether a license the specific license is “NCSA” or “X11”, you may simply regard them as an “MIT-style” license. Similarly, GPL version 1, version 2, and version 3 may just be grouped as “GPL”.

License groups permit categoring similar licenses. Groups also have attributes such as a name, description and color. For example, if there are some licenses that you do not like, then you can create a license group named “Bad” with the description “Licenses I don't like” and the color “Red”. Similarly, green can be used for licenses that you do like.

License groups can be associated with license or other license groups. This way, you can have subgroups called “GPL v1” and “GPL v2”, both of which are included in the “GPL” group. If you modify the licenses within a subgroup (e.g., add a license to the “GPL v2” group), then parent groups immediately inherit the change (the “GPL” group sees the addition).

Default License Groups

Currently, there are three default license groups: Similar Text, FSF, and Fedora.

Managing License Groups

Using the Manage Groups option (Organize » License » Manage Groups), you can create new groups, edit group properties (everything from name to which licenses are in the group), or delete groups. You can even modify the default license groups (Organize » License » Default Groups).

License colors are a little special. If you select a non-white color, then that color will be used when you view the license groups. However, if the color is white (#ffffff), then the group will inherit the colors of any subgroups. For example, if the subgroups are green, green, and red, then the top group will be a combination (a greenish-red color). While the actual color mix may not be informative, seeing that it is not one of the eight standard group colors is a clear indication of multiple colors within the subgroup.

Viewing License Groups

To view which files are associated with a license group:

  1. Click on the Browse tab, to display the Browse screen.
  2. Select an uploaded file to view by navigating to it using the Folder Navigation and Uploads areas of the Browse screen.
  3. Click on the file name of the uploaded file.
  4. In the top-right micro-menu of the resulting screen, find the option called “License Groups”.
  5. Select the License Groups option.

The following is an example of the License Group screen:

The resulting page shows the license group histogram on the left, and the directory listing on the right. Only license groups associated with files are shown; empty license groups are not shown. The histogram includes:

As with the license histogram, the directory listing includes bold and regular items. Clicking on a bold name (e.g., a directory or a container file) will shows the contents. Clicking on a regular name will show the licenses within the file.