1
0
mirror of https://github.com/github/choosealicense.com synced 2024-11-04 18:58:50 +01:00
Go to file
2013-12-10 09:04:21 +02:00
_includes Rename clearfix class. 2013-12-10 09:04:20 +02:00
_layouts Rename clearfix class. 2013-12-10 09:04:20 +02:00
css Move qTip inclusion at the top so that it's clear. 2013-12-10 09:04:21 +02:00
images Compress images. 2013-10-30 19:51:56 +02:00
javascripts Merge pull request #145 from XhmikosR/zeroclipboard 2013-12-09 09:06:40 -08:00
licenses No License description missing that to complete sentence 2013-12-08 20:55:23 -05:00
script run html-proofing as part of travis build 2013-10-23 00:23:57 -07:00
_config.yml sort rules by label 2013-11-29 20:57:35 -05:00
.gitattributes Adding proper gitignore and gitattributes file 2012-06-12 20:04:45 -07:00
.gitignore add coffeescrpt to scripts 2013-07-13 15:25:55 -04:00
.ruby-version upgrade to gh-pages 4 2013-09-14 00:39:58 -04:00
.travis.yml Remove trailing spaces. 2013-10-30 20:34:52 +02:00
about.md Typo anyways should be anyway; Sentence needs a comma to break in 2013-12-02 20:32:36 -05:00
CNAME revert 48261c1c77 2013-07-25 13:51:32 -04:00
CONTRIBUTING.md Remove trailing spaces. 2013-10-30 20:34:52 +02:00
favicon.ico initial work on new design 2012-09-12 15:20:27 -04:00
Gemfile Use double quotes consistently. 2013-10-30 20:39:55 +02:00
Gemfile.lock upgrade github-pages 2013-11-29 20:37:58 -05:00
index.html Rename clearfix class. 2013-12-10 09:04:20 +02:00
LICENSE.md Remove trailing spaces. 2013-10-30 20:34:52 +02:00
licenses.html made partial for license overview sections 2013-11-06 11:24:34 -05:00
licenses.json Remove trailing spaces. 2013-10-30 20:34:52 +02:00
no-license.md Remove trailing spaces. 2013-10-30 20:34:52 +02:00
Rakefile run html-proofing as part of travis build 2013-10-23 00:23:57 -07:00
README.md Remove trailing spaces. 2013-10-30 20:34:52 +02:00
terms-of-service.md Remove trailing spaces. 2013-10-30 20:34:52 +02:00

Choose a License Web Site Build Status

Like a Choose Your Own Adventure site, but only much less interesting.

Intro

A lot of repositories on GitHub.com don't have a license. GitHub provides a license chooser, but if you don't know anything about licenses, how are you supposed to make an informed decision.

ChooseALicense.com is designed to help people make an informed decision about licenses.

Immediate Goals

  • Politics Free - Let's just not get into it.
  • Well designed, but that goes without saying.
  • The homepage should have just enough to help 99% of folks make a decision.
  • For the 1%, the site will contain a list of licenses common for specific communities and situations.
  • Not comprehensive. Seems like an odd goal, but there are a bajillion (I counted) licenses out there. We're going to have to filter that down to a small list of those that matter.

Run It On Your Machine

  1. git clone https://github.com/github/choosealicense.com
  2. cd choosealicense.com
  3. script/bootstrap
  4. script/server
  5. Open localhost:4000 in your favorite browser

Adding a license

Licenses sit in the /licenses folder as markdown (.md) files. Each license has YAML front matter describing the license's properties. The body of the markdown file should be the text of the license. The available metadata fields are:

  • title - The name of the license
  • layout - This should be license
  • permalink - The absolute URL to the license, beginning with /licenses/
  • source - URL to the license source text
  • note - The note field in the sidebar (optional)
  • how - How to use the license, also in the sidebar
  • required, permitted, forbidden - bulleted list of rules applicable to the license (see below)
  • filename - The filename to be created on GitHub.com when a repository is initialized with this license.

The licenses on choosealicense.com are regularly imported to GitHub.com to be used as the list of licenses available when creating a repository. When we create a repository, we will replace certain strings in the license with variables from the repository. These can be used to create accurate copyright notices. The available variables are:

  • [fullname] - The full name or username of the repository owner
  • [login] - The repository owner's username
  • [email] - The repository owner's primary email address
  • [project] - The repository name
  • [description] - The description of the repository
  • [year] - The current year

Rules

  • Rules (the license's properties) are stored as a bulleted list within the licenses YAML front matter. A full list of rules can be found in the repository's _config.yml file. Each rule has a name e.g., include-copyright, a human-readable label, e.g., Copyright inclusion, and a description Include the original copyright with the code. To add a new rule, simply add it to config.yml and reference it in the appropriate license.

License

The content of this project itself is licensed under the Creative Commons Attribution 3.0 license, and the underlying source code used to format and display that content is licensed under the MIT license.