Warning, /graphics/digikam/CONTRIBUTING.md is written in an unsupported language. File is not indexed.

0001 # COMMIT POLICY
0002 
0003 Everybody is welcome to committing small fixes and one-liners
0004 without prior notification to the maintainer, provided that the
0005 following rules are followed:
0006 
0007     1. Please keep your commits as small and as atomic as possible.
0008     2. Do not push both formatting and code changes in the same commit.
0009     3. Do not fix coding style and code issues in the same commit.
0010 
0011 For larger commits, please use Gitlab functionalities or send a patch to
0012 [bugzilla](https://bugs.kde.org/describecomponents.cgi?product=digikam).
0013 A rule of thumb to check whether your commit is a major commit is
0014 if it affects more than 5 lines of code.
0015 
0016 Break down larger fixes into smaller commits. Even if you push the
0017 commits with one "git push", git preserves your commit info.
0018 
0019 For the todo list, see bugzilla for details which is the complete story of the project.
0020 
0021 # CODING STYLE
0022 
0023 See the coding style detailed at this [Doxygen page](https://www.digikam.org/api/index.html#codecontrib).
0024 
0025 # DOCUMENTATION
0026 
0027 See The API documentation to generate with Doxygen. You will find all information about the dependencies,
0028 the configuration options, the rules to compile and install, and all pointers to contribute to the project as a developer.
0029 
0030 Install Doxygen and Graphviz, and then run make doc from build directory. You can also run doxygen command line tool
0031 directly from this folder or consult the Mainpage.dox file.
0032 
0033 [Online version](https://www.digikam.org/api/index.html)
0034 
0035 # LICENSING
0036 
0037 See the guideline of licenses policy:
0038 
0039 [SPDX](https://spdx.org/licenses/)
0040 [KDE](https://community.kde.org/Policies/Licensing_Policy)
0041 
0042 License files are hosted in LICENSE/ directory.
0043 
0044 Usual usages:
0045 
0046 BSD-3       : cmake, sh, rb, py, pl.
0047 GPL2+/LGPL2+: cpp, c, h, xsl, conf, nsh, nsl.
0048 CC0-1       : yml.
0049 MIT         : css, js.