CONTRIBUTING.md

   1 # Contributing Guidelines
   2 (See <http://wiki.openwrt.org/doc/devel/packages> for overall format and construction)
   3
   4
   5 All packages you commit or submit by pull-request should follow these simple guidelines:
   6
   7 * Package a version which is still maintained by the upstream author.
   8 * Will be updated regularly to maintained and supported versions.
   9 * Have no dependencies outside the OpenWrt core packages or this repository feed.
  10 * Have been tested to compile with the correct includes and dependencies. Please also test with "Compile with full language support" found under "General Build Settings" set if language support is relevant to your package.
  11 * Do NOT use a rolling source file (e.g. foo-latest.tar.gz) or the head of a branch as source for the package since that would create unpredictable builds which change over time.
  12 * Best of all -- it works as expected!
  13
  14 Makefile contents should contain:
  15
  16 * An up-to-date copyright notice. Use OpenWrt if no other present or supply your own.
  17 * A (PKG_)MAINTAINER definition listing either yourself or another person in the field.
  18     (E.g.: PKG_MAINTAINER:= Joe D. Hacker `<jdh@jdhs-email-provider.org`>)
  19 * A PKG_LICENSE tag declaring the main license of the package.
  20     (E.g.: PKG_LICENSE:=GPL-2.0+) Please use SPDX identifiers if possible (see list at the bottom).
  21 * An optional PKG_LICENSE_FILES including the filename of the license-file in the source-package.
  22     (E.g.: PKG_LICENSE_FILES:=COPYING)
  23
  24 Commits in your pull-requests should:
  25
  26 * Have a useful description prefixed with the package name
  27     (E.g.: "foopkg: Add libzot dependency")
  28 * Include Signed-off-by in the comment
  29     (See <https://dev.openwrt.org/wiki/SubmittingPatches#a10.Signyourwork>)
  30
  31 If you have commit access:
  32
  33 * Do NOT use git push --force.
  34 * Do NOT commit to other maintainer's packages without their consent.
  35 * Use Pull Requests if you are unsure and to suggest changes to other maintainers.
  36
  37 Gaining commit access:
  38
  39 * We will gladly grant commit access to responsible contributors who have made
  40   useful pull requests and / or feedback or patches to this repository or
  41   OpenWrt in general. Please include your request for commit access in your
  42   next pull request or ticket.
  43
  44 Release Branches:
  45
  46 * Branches named "for-XX.YY" (e.g. for-14.07) are release branches.
  47 * These branches are built with the respective OpenWrt release and are created
  48   during the release stabilisation phase.
  49 * Please ONLY cherry-pick or commit security and bug-fixes to these branches.
  50 * Do NOT add new packages and do NOT do major upgrades of packages here.
  51 * If you are unsure if your change is suitable, please use a pull request.
  52
  53 ####Common LICENSE tags (short list)
  54 (Complete list can be found at: <http://spdx.org/licenses>)
  55 ####
  56
  57 | Full Name | Identifier  |
  58 |---|:---|
  59 |Apache License 1.0|Apache-1.0|
  60 |Apache License 1.1|Apache-1.1|
  61 |Apache License 2.0|Apache-2.0|
  62 |Artistic License 1.0|Artistic-1.0|
  63 |Artistic License 1.0 (Perl)|Artistic-1.0-Perl|
  64 |Artistic License 1.0 w/clause 8|Artistic-1.0-cl8|
  65 |Artistic License 2.0|Artistic-2.0|
  66 |BSD 2-clause "Simplified" License|BSD-2-Clause|
  67 |BSD 2-clause FreeBSD License|BSD-2-Clause-FreeBSD|
  68 |BSD 2-clause NetBSD License|BSD-2-Clause-NetBSD|
  69 |BSD 3-clause "New" or "Revised" License|BSD-3-Clause|
  70 |BSD 3-clause Clear License|BSD-3-Clause-Clear|
  71 |BSD 4-clause "Original" or "Old" License|BSD-4-Clause|
  72 |BSD Protection License|BSD-Protection|
  73 |BSD with attribution|BSD-3-Clause-Attribution|
  74 |BSD-4-Clause (University of California-Specific)|BSD-4-Clause-UC|
  75 |GNU General Public License v1.0 only|GPL-1.0|
  76 |GNU General Public License v1.0 or later|GPL-1.0+|
  77 |GNU General Public License v2.0 only|GPL-2.0|
  78 |GNU General Public License v2.0 or later|GPL-2.0+|
  79 |GNU General Public License v3.0 only|GPL-3.0|
  80 |GNU General Public License v3.0 or later|GPL-3.0+|
  81 |GNU Lesser General Public License v2.1 only|LGPL-2.1|
  82 |GNU Lesser General Public License v2.1 or later|LGPL-2.1+|
  83 |GNU Lesser General Public License v3.0 only|LGPL-3.0|
  84 |GNU Lesser General Public License v3.0 or later|LGPL-3.0+|
  85 |GNU Library General Public License v2 only|LGPL-2.0|
  86 |GNU Library General Public License v2 or later|LGPL-2.0+|
  87 |Fair License|Fair|
  88 |ISC License|ISC|
  89 |MIT License|MIT|
  90 |No Limit Public License|NLPL|
  91 |OpenSSL License|OpenSSL|
  92 |X11 License|X11|
  93 |zlib License|Zlib|