mirror of
https://bitbucket.org/smil3y/katie.git
synced 2025-02-23 18:32:55 +00:00
contributing notes
Signed-off-by: Ivailo Monev <xakepa10@gmail.com>
This commit is contained in:
parent
4fad9db975
commit
a17ea3e663
2 changed files with 50 additions and 2 deletions
50
CONTRIBUTING
Normal file
50
CONTRIBUTING
Normal file
|
@ -0,0 +1,50 @@
|
|||
## Code style
|
||||
The best thing you can do is follow the code style used in the files you are
|
||||
changing or look for files in format same as those you are adding and use that
|
||||
code style.
|
||||
|
||||
## Static data
|
||||
In many cases using immutable static data rather than generating at runtime and
|
||||
caching it is more optimal. If you want to add code that uses data tables use
|
||||
naming such as `MIBTbl` which makes it easy to look for and Python script for
|
||||
generating the data tables if possible. Check out the existing scripts
|
||||
(https://github.com/fluxer/katie/tree/master/scripts) for examples.
|
||||
|
||||
## Compatibility
|
||||
Neither source nor binary compatibility is guratneed between releases which
|
||||
means hacks for binary compatibility and such are not required. If there is
|
||||
breaking change, the changes that need to be applied to other projects should
|
||||
be kept to minimum with backwards compatiblity where possible and usually noted
|
||||
at the main wiki page (https://github.com/fluxer/katie/wiki). Note your changes
|
||||
there if neccessary once it is accepted, ask for write access if you cannot
|
||||
edit pages on the wiki.
|
||||
|
||||
## Standards
|
||||
All standard requirements besides C++11 compatible runtime and compiler are
|
||||
should be checked for during build if they are newer than POSIX.1c
|
||||
(https://en.wikipedia.org/wiki/POSIX). Read any documentation that may be
|
||||
relevant to the changes you make such as manual pages for Linux
|
||||
(https://linux.die.net/man/), FreeBSD (https://www.freebsd.org/cgi/man.cgi)
|
||||
and OpenBSD (https://man.openbsd.org/).
|
||||
|
||||
## Tests
|
||||
You can import tests and adjust them as needed from stock Qt4 copy
|
||||
(https://github.com/fluxer/qt) if there are no tests in place relevant to the
|
||||
changes you do. Adding regression tests is optional.
|
||||
|
||||
## Translations
|
||||
To contribute translations either use the web interface at
|
||||
https://www.transifex.com/smil3y/katie or the .pot files provided as base and
|
||||
submit them as pull request.
|
||||
|
||||
## Licensing
|
||||
Unless you make additions you do not have to worry about that. Otherwise use
|
||||
as liberal as possible, preferably public domain (no license) or 3-clause BSD.
|
||||
The reason for that is simple - many vendors (distributions) and consumers will
|
||||
have strict requirements what they distribute and/or use. Debian for an example
|
||||
does not enable by default non-free software repository thus user interaction
|
||||
is required actions before non-free software can be installed.
|
||||
|
||||
If you cannot contribute your changes with license that is less or equally
|
||||
permisive than those already in use (3-clause BSD, FDL v1.3 and LGPL v2.1+)
|
||||
than your contribution may not be acceptable.
|
|
@ -1,2 +0,0 @@
|
|||
To contribute translation use the .pot files provided as base. If you are
|
||||
interested visit https://www.transifex.com/smil3y/katie.
|
Loading…
Add table
Reference in a new issue