Click to see rules
โ
license-file-exists
#
Found file (LICENSE
). New Relic requires that all open source projects have an associated license contained within the project. This license must be permissive (e.g. non-viral or copyleft), and we recommend Apache 2.0 for most use cases. For more information please visit https://docs.google.com/document/d/1vML4aY_czsY0URu2yiP3xLAKYufNrKsc7o4kjuegpDw/edit.
โ
readme-file-exists
#
Found file (README.md
). New Relic requires a README file in all projects. This README should give a general overview of the project, and should point to additional resources (security, contributing, etc.) where developers and users can learn further. For more information please visit https://github.com/newrelic/open-source-tools/tree/master/javascript/oss-template.
โ
readme-starts-with-nr1-catalog-header
The first 1 lines contain all of the requested patterns. (README.md
). The README of a community plus project should have a NR1 Catalog header at the start of the README. If you already have a NR1 Catalog header and this rule is failing, your header may be out of date, and you should update your header with the suggested one below. For more information please visit https://opensource.newrelic.com/oss-category/.
โ
readme-contains-security-section
#
Contains a security section (README.md
). New Relic recommends having a Security section in your README to address concerns such as vulnerability reporting. This security section should also contain a link to the security policy (found under the "Security" tab of the repository). For an example of this section, please see the NR1 Catalog Template. For more information please visit https://nerdlife.datanerd.us/new-relic/security-guidelines-for-publishing-source-code.
โ
readme-contains-link-to-security-policy
#
Contains a link to the security policy for this repository (README.md
). New Relic recommends referencing the open source security policy (https://github.com/newrelic/<repo-name>/security/policy
or ../../security/policy
) in a Security section in the README. For an example of this, please see the NR1 Catalog Template. For more information please visit https://nerdlife.datanerd.us/new-relic/security-guidelines-for-publishing-source-code.
โ
readme-contains-discuss-topic
#
Contains a link to the appropriate discuss.newrelic.com topic (README.md
). New Relic recommends directly linking the your appropriate discuss.newrelic.com topic in the README, allowing developer an alternate method of getting support. For more information please visit https://nerdlife.datanerd.us/new-relic/security-guidelines-for-publishing-source-code.
โ
third-party-notices-file-exists
#
Found file (THIRD_PARTY_NOTICES.md
). A THIRD_PARTY_NOTICES.md file must be present to grant attribution to all dependencies being used by this project. For JavaScript projects, you can generate this file using the oss-cli. For more information please visit https://docs.google.com/document/d/1y644Pwi82kasNP5VPVjDV8rsmkBKclQVHFkz8pwRUtE/view.
โ
code-of-conduct-should-not-exist-here
#
New Relic has moved the CODE_OF_CONDUCT
file to a centralized location where it is referenced automatically by every repository in the New Relic organization. Because of this change, any other CODE_OF_CONDUCT
file in a repository is now redundant and should be removed. For more information please visit https://docs.google.com/document/d/1y644Pwi82kasNP5VPVjDV8rsmkBKclQVHFkz8pwRUtE/view. Did not find a file matching the specified patterns. All files passed this test.
โ
github-actions-workflow-file-exists
#
Found file (.github/workflows/catalog.yml
). Any Community Plus project must integrate with GitHub actions. For more information please visit https://docs.google.com/document/d/1y644Pwi82kasNP5VPVjDV8rsmkBKclQVHFkz8pwRUtE/view.
โ
nr1-catalog-config-file-exists
#
Found file (catalog/config.json
).
โ
nr1-catalog-screenshots-directory-exists
#
Found file (catalog/screenshots
).
โ
nr1-catalog-documentation-file-exists
#
Found file (catalog/documentation.md
).
โ
package-scripts-present
#
An eslint-check
and eslint-fix
npm script found in file (package.json
). NPM scripts for ESLint (eslint-check
and eslint-fix
) are required to properly integrate with the nerdpack system.