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:12] – [Development of Roslisp Packages] gkazhoya | doc:guidelines [2019/05/20 11:29] – [Copyright notices] gkazhoya | ||
---|---|---|---|
Line 35: | Line 35: | ||
**Lisp** | **Lisp** | ||
- | * Pay attention to the indentation! | + | * Pay attention to the indentation!!! |
* Try not to exceed 80 symbols in width in your code | * Try not to exceed 80 symbols in width in your code | ||
- | * Lisp names (variables, classes, methods, packages) are all lowercase with dashes in between: my-awesome-lisp-variable | + | * Lisp names (variables, classes, methods, packages) are all lowercase with dashes in between: |
* Do you usually get that feeling that something is underdocumented? | * Do you usually get that feeling that something is underdocumented? | ||
* Try not to '' | * Try not to '' | ||
Line 48: | Line 48: | ||
**Ros-related** | **Ros-related** | ||
- | * 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, | ||