Update fwknopd to 2.6.5
[feed/packages.git] / CONTRIBUTING.md
index 2b7f39bb76998cb4eb65cef76e3015e89c4e2b92..5edacdc2a81ac33073bfc65d8c6b901232fe2788 100644 (file)
@@ -1,12 +1,14 @@
 # Contributing Guidelines  
-(See <http://wiki.openwrt.org/doc/devel/packages> for overall format and contstruction)
+(See <http://wiki.openwrt.org/doc/devel/packages> for overall format and construction)
+
 
 All packages you commit or submit by pull-request should follow these simple guidelines:
 
 * Package a version which is still maintained by the upstream author.
 * Will be updated regularly to maintained and supported versions.
 * Have no dependencies outside the OpenWrt core packages or this repository feed.
-* Have been tested to compile with the correct includes and dependencies. Also, test with "Compile with full language support" found under "General Build Settings" set.
+* 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.
+* 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.
 * Best of all -- it works as expected!
 
 Makefile contents should contain:
@@ -14,10 +16,12 @@ Makefile contents should contain:
 * An up-to-date copyright notice. Use OpenWrt if no other present or supply your own.
 * A (PKG_)MAINTAINER definition listing either yourself or another person in the field.  
     (E.g.: PKG_MAINTAINER:= Joe D. Hacker `<jdh@jdhs-email-provider.org`>)
-* A PKG_LICENSE and optional PKG_LICENSE_FILE definition showing the license type and what file(s) in the package, if present, contain it respectively. The license type tag should be in the form suggested by the Software Package Data Exchange (SPDX) license list. Using these normalized tags will aide us in filtering packages based on license type. See below for a abbreviated list of some common license tags.
-    (E.g.: PKG_LICENSE:=GPL-2.0+; PKG_LICENSE_FILE:=COPYING)
+* A PKG_LICENSE tag declaring the main license of the package.
+    (E.g.: PKG_LICENSE:=GPL-2.0+) Please use SPDX identifiers if possible (see list at the bottom).
+* An optional PKG_LICENSE_FILES including the filename of the license-file in the source-package.
+    (E.g.: PKG_LICENSE_FILES:=COPYING)
 
-Commits and pull-requests:
+Commits in your pull-requests should:
 
 * Have a useful description prefixed with the package name  
     (E.g.: "foopkg: Add libzot dependency")
@@ -30,6 +34,13 @@ If you have commit access:
 * Do NOT commit to other maintainer's packages without their consent.
 * Use Pull Requests if you are unsure and to suggest changes to other maintainers.
 
+Gaining commit access:
+
+* We will gladly grant commit access to responsible contributors who have made
+  useful pull requests and / or feedback or patches to this repository or
+  OpenWrt in general. Please include your request for commit access in your
+  next pull request or ticket.
+
 Release Branches:
 
 * Branches named "for-XX.YY" (e.g. for-14.07) are release branches.