Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
doc:guidelines [2019/05/16 13:13] – [Coding Style] gkazhoya | doc:guidelines [2019/05/20 11:29] – [Copyright notices] gkazhoya | ||
---|---|---|---|
Line 49: | Line 49: | ||
* ROS packages' | * ROS packages' | ||
+ | |||
+ | |||
+ | ==== Copyright notices ==== | ||
+ | CRAM is open source software licensed under the BSD licence. | ||
+ | This means the code can be used by any third party without having to contribute anything back and having to mention the original authors. | ||
+ | Our copyright notice is there to allow others to use our software without being afraid of being sued. | ||
+ | |||
+ | An example copyright notice can be found in the header of most '' | ||
+ | |||
+ | Here are some guidelines on how to deal with the copyright notice of your code: | ||
+ | * When you create a new '' | ||
+ | * If you simply copy pasted a file, please keep the original notice intact. | ||
+ | * For non-sourcecode files such as a '' | ||
+ | * When editing an existing file, you can add your name into the header if you made a substantial contribution to the code. | ||
+ | |||
+ | A contribution is considered substantial if: | ||
+ | * you added a new feature, | ||
+ | * you fixed a major bug and thereby edited many lines of code in the file, | ||
+ | * you made a major refactoring of the code and improved readability and maintainability greatly. | ||
+ | |||
+ | A contribution is considered not substantial if: | ||
+ | * you fixed a typo, | ||
+ | * fixed indentation, | ||
+ | * slightly improved a documentation string, | ||
+ | * other minor contributions such as minor refactoring and nicification, | ||
+ | * minor bug fixes, | ||
+ | * copy paste of existing code with minor tweaks. | ||
+ | |||
+ | This definition is, of course, not quantitative. If you are unsure, ask the current main maintainer of the software for an advice or look on the Internet for some inspiration, | ||