CONTRIBUTING.rst 1.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
  1. Contributing to CMake
  2. *********************
  3. The following summarizes the process for contributing changes.
  4. See documentation on `CMake Development`_ for more information.
  5. .. _`CMake Development`: Help/dev/README.rst
  6. Community
  7. =========
  8. CMake is maintained and supported by `Kitware`_ and developed in
  9. collaboration with a productive community of contributors.
  10. Please subscribe and post to the `CMake Developers List`_ to raise
  11. discussion of development topics.
  12. .. _`Kitware`: http://www.kitware.com/cmake
  13. .. _`CMake Developers List`: https://cmake.org/mailman/listinfo/cmake-developers
  14. Patches
  15. =======
  16. CMake uses `Kitware's GitLab Instance`_ to manage development and code review.
  17. To contribute patches:
  18. #. Fork the upstream `CMake Repository`_ into a personal account.
  19. #. Run `Utilities/SetupForDevelopment.sh`_ for local configuration.
  20. #. See the `CMake Source Code Guide`_ for coding guidelines.
  21. #. Base all new work on the upstream ``master`` branch.
  22. #. Create commits making incremental, distinct, logically complete changes.
  23. #. Push a topic branch to a personal repository fork on GitLab.
  24. #. Create a GitLab Merge Request targeting the upstream ``master`` branch.
  25. The merge request will enter the `CMake Review Process`_ for consideration.
  26. .. _`Kitware's GitLab Instance`: https://gitlab.kitware.com
  27. .. _`CMake Repository`: https://gitlab.kitware.com/cmake/cmake
  28. .. _`Utilities/SetupForDevelopment.sh`: Utilities/SetupForDevelopment.sh
  29. .. _`CMake Source Code Guide`: Help/dev/source.rst
  30. .. _`CMake Review Process`: Help/dev/review.rst
  31. License
  32. =======
  33. We do not require any formal copyright assignment or contributor license
  34. agreement. Any contributions intentionally sent upstream are presumed
  35. to be offered under terms of the OSI-approved BSD 3-clause License.
  36. See `Copyright.txt`_ for details.
  37. .. _`Copyright.txt`: Copyright.txt