2015-08-22 15:25:16 -04:00
|
|
|
# Each license has YAML front matter describing the license's properties.
|
|
|
|
# The available fields are:
|
|
|
|
|
|
|
|
- name: title
|
|
|
|
description: The SPDX-compliant, human-readable license name
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: source
|
|
|
|
description: The URL to the license source text
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: description
|
|
|
|
description: A human-readable description of the license
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: how
|
|
|
|
description: Instructions on how to implement the license
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: required
|
|
|
|
description: Bulleted list of required rules
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: permitted
|
|
|
|
description: Bulleted list of permitted rules
|
|
|
|
required: true
|
|
|
|
|
|
|
|
- name: forbidden
|
|
|
|
description: Bulleted list of forbidden rules
|
|
|
|
required: true
|
|
|
|
|
|
|
|
# Optional fields
|
|
|
|
|
|
|
|
- name: note
|
|
|
|
description: Additional information about the licenses
|
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: using
|
|
|
|
description: 'A list of notable projects using the license in the form of `project_name: "url"`'
|
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: hidden
|
2016-02-02 16:10:39 -08:00
|
|
|
description: Whether the license is hidden from the license list (defaults to true)
|
2015-08-22 15:25:16 -04:00
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: redirect_from
|
2016-02-02 16:10:39 -08:00
|
|
|
description: Relative path(s) to redirect to the license from, to prevent breaking old URLs
|
2015-08-22 15:25:16 -04:00
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: featured
|
|
|
|
description: Whether the license should be featured on the main page (defaults to false)
|
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: nickname
|
2016-02-02 16:10:39 -08:00
|
|
|
description: A shorter, human-readable license name where the SPDX license name (`title` above) is long
|
2015-08-22 15:25:16 -04:00
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: variant
|
2016-02-02 16:10:39 -08:00
|
|
|
description: Whether the license is a variant of a family of licenses (defaults to false)
|
2015-08-22 15:25:16 -04:00
|
|
|
required: false
|
|
|
|
|
2015-09-09 00:04:34 +01:00
|
|
|
- name: family
|
2015-08-22 15:25:16 -04:00
|
|
|
description: If part of a license family, the name of the license family (e.g., `GPL`)
|
|
|
|
required: false
|
|
|
|
|
|
|
|
- name: tab-slug
|
2016-02-02 16:10:39 -08:00
|
|
|
description: If part of a license family, a license slug containing only `a-z`, `0-9`, and `_` characters, used for internal links on the licenses page
|
2015-08-22 15:25:16 -04:00
|
|
|
required: false
|