github / github/choosealicense.com

Annotating license texts with license rules

Open
#441 2 comments 8 reactions 0 assignees View on GitHub
enhancement help wanted
Dominant language
HTML
Stars
4.2k
Forks
1.6k
Avg merge
19m
Merged PRs (30d)
5

Description

[Comment/question today](https://github.com/github/choosealicense.com/pull/320#issuecomment-230746990) about whether EUPL-1.1 is accurately described reminded me to file this enhancement idea.

For each license, license rules could be annotated with ranges of text in the license pertinent to the rule. Highlighting of ranges could be turned on/off on individual license pages by selecting in the license rules (permissions/conditions/limitations) table. Very crude mockup taking a very simple case (the one condition of MIT).

![mit-highlight-condition](https://cloud.githubusercontent.com/assets/40415/16633043/25735510-437c-11e6-84f8-1e504d48f345.png)

Obviously this is not a big help for MIT, but for longer licenses, it can be tricky to figure out what bits of the license are pertinent for a particular rule, at least if you only want to read once, which is more already than I suspect most people do.

Such annotations _might_ be very helpful to "demystify" licenses, and creating them might be good QA for choosealicense.com license descriptions.

Probably the simplest way to to annotate would be to have one or more full text extracts for each license for each rule, though there are other ways to do it, inline or [out of band](https://github.com/hypothesis/h/wiki/robust-anchors).

Very low priority, may even be a bad idea, just recording it for now.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.