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.