mirror of
https://github.com/github/choosealicense.com
synced 2024-12-22 21:00:10 +01:00
570f69e4ec
- document criteria for whether a license is hidden - needed for license spectrum on /licenses OR - on 'popular' list at https://opensource.org/licenses (some other list could be used in the future) - adjust license properties and tests accordingly This gets non-hidden list back close to what it was before #386 and (pending licensee vendoring this change, licensee release, and github.com licensee dependency version bump) some commonly requested licenses (eg #413 #449) will reappear in the github.com license drop-down.
61 lines
1.8 KiB
YAML
61 lines
1.8 KiB
YAML
# Each license has YAML front matter describing the license's properties.
|
|
# The available fields are:
|
|
|
|
- name: title
|
|
description: The license full name specified by http://spdx.org/licenses/
|
|
required: true
|
|
|
|
- name: spdx-id
|
|
description: Short identifier specified by http://spdx.org/licenses/
|
|
required: required
|
|
|
|
- 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: conditions
|
|
description: Bulleted list of required rules
|
|
required: true
|
|
|
|
- name: permissions
|
|
description: Bulleted list of permitted rules
|
|
required: true
|
|
|
|
- name: limitations
|
|
description: Bulleted list of limited rules
|
|
required: true
|
|
|
|
# Optional fields
|
|
|
|
- name: featured
|
|
description: Whether the license should be featured on the main page (defaults to false)
|
|
required: false
|
|
|
|
- name: hidden
|
|
description: Whether the license is neither [popular](https://opensource.org/licenses) nor fills out the [spectrum of licenses](http://choosealicense.com/licenses/) from strongly conditional to unconditional (defaults to true)
|
|
required: false
|
|
|
|
- name: nickname
|
|
description: Customary short name if applicable (e.g, GPLv3)
|
|
required: false
|
|
|
|
- name: note
|
|
description: Additional information about the licenses
|
|
required: false
|
|
|
|
- name: using
|
|
description: 'A list of up to 3 notable projects using the license with straightforward LICENSE files which serve as examples newcomers can follow and that can be detected by [licensee](https://github.com/benbalter/licensee) in the form of `project_name: license_file_url`'
|
|
required: false
|
|
|
|
- name: redirect_from
|
|
description: Relative path(s) to redirect to the license from, to prevent breaking old URLs
|
|
required: false
|