[jira] [Created] (BROOKLYN-593) GitHub doesn't recognize Apache Brooklyn license

["Andrea Kao (JIRA)" <ji...@apache.org>]

Andrea Kao created BROOKLYN-593:
-----------------------------------

             Summary: GitHub doesn't recognize Apache Brooklyn license
                 Key: BROOKLYN-593
                 URL: https://issues.apache.org/jira/browse/BROOKLYN-593
             Project: Brooklyn
          Issue Type: Documentation
            Reporter: Andrea Kao


Hello!

GitHub uses a library called Licensee to identify a project's license type. It shows this information in the status bar and via the API if it can unambiguously identify the license. Licensee is currently unable to recognize Apache Brooklyn's license type.

This is in part due to the fact that the LICENSE file doesn't contain the _full_ text of the Apache license (i.e., it is missing the Appendix at the end of the license).

A simple fix might involve the following steps:
 * restoring the Appendix to the end of the Apache license text in the LICENSE file
 * removing all text preceding the beginning of the license text in the LICENSE file
 * updating the README to include a "License" section, which would store the text that was removed from the beginning of the LICENSE file. This could read as follows: 

{noformat}
### License
This software is distributed under the Apache License, version 2.0, copyright (c) The Apache Software Foundation and contributors. Please see the LICENSE file for (1) the full text of the Apache License, followed by (2) notices for bundled software and (3) licenses for bundled software.
{noformat}

(For repositories licensed with the Apache License, Licensee is unable to detect the correct license type unless the LICENSE file begins with the full text of the Apache license.)

For comparison purposes, here is the output that I get when I run Licensee locally on Apache Brooklyn's remote repo:

{noformat}
$ licensee detect https://github.com/apache/brooklyn
 License: Other
 Matched files: LICENSE
 LICENSE:
 Content hash: 5717ab47e05db42d81bdfc383a1ae6b9a53b67f4
 License: Other
 Closest licenses:
 Apache-2.0 similarity: 74.91%
 ECL-2.0 similarity: 73.37%
 EPL-2.0 similarity: 48.59%
{noformat}

And here is the output that I get when I run Licensee on my local Apache Brooklyn clone (in which I have made the changes listed above):

{noformat}
$ licensee detect ../brooklyn/
License:        Apache License 2.0
Matched files:  LICENSE, README.md
LICENSE:
  Content hash:  4f3dee90d3ff02d566b067c25982c2bfd7e360c1
  Confidence:    100.00%
  Matcher:       Licensee::Matchers::Exact
  License:       Apache License 2.0
README.md:
  Content hash:  b77b21d0aa303586e2f6ccc1dd72133caad05ac1
  Confidence:    90.00%
  Matcher:       Licensee::Matchers::Reference
  License:       Apache License 2.0
  Closest licenses:
    WTFPL similarity:  23.88%
    Zlib similarity:   19.05%
    MS-PL similarity:  18.89%
{noformat}



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)