-
Notifications
You must be signed in to change notification settings - Fork 365
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add contributing information. #320
Conversation
A link to this file will show up whenever a new Pull Request on Github is created.
* Each pull request needs to be documented by an issue in the [issue tracker](https://github.com/nest/nest-simulator/issues) explaining the reason for the changes and the solution. The issue is also the place for discussions about the code. | ||
* New features like SLI or PyNEST functions, neuron or synapse models need to be accompanied by one or more tests written either in SLI or Python. New features for the NEST kernel need a test written in SLI. | ||
* Each change to the code has to be reflected also in the corresponding examples and documentation. | ||
* All source code has to be adhering to the Coding Guidelines for [C++](https://nest.github.io/nest-simulator/coding_guidelines_c++) and [SLI](https://nest.github.io/nest-simulator/coding_guidelines_sli) in order to pass the continuous integration system checks. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
coding guidelines
Great except for some Excessive Capitalisation |
👍 from me but maybe @heplesser has some additional feedback |
@@ -0,0 +1,48 @@ | |||
# How to contribute | |||
|
|||
The NEST simulator is a scientific tool and as such it is never ready and constantly changing to meet the needs of novel neuroscientific endeavors. Here you find the the most important information on how you can contribute to NEST. This document is an excerpt from our [developer space](https://nest.github.io/nest-simulator/), which provides more detailed information. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
double "the" in "find the the most important"
Please consider waiting for answers to my comments before merging. |
## Getting started | ||
|
||
* Make sure you have a [GitHub account](https://github.com/signup/free) | ||
* The development workflow is based purely on pull requests. This [article](https://nest.github.io/nest-simulator/development_workflow) gives information on how to work with git and GitHub, if you are new to it. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
No comma before "if you are new to it".
|
||
We review each pull request according to our [code review guidelines](https://nest.github.io/nest-simulator/code_review_guidelines): | ||
|
||
* In general, the rule is that each pull request needs an OK from the CI platform and at least two reviewers to be merged. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
perhaps it's worth mentioning that if it is relevant to an issue then it should say so explicitly (now we have removed the line about requiring an issue number)
I think that all comments have been sufficiently addressed. Many thanks for providing this. 👍 and merging. |
A link to this file will show up whenever a new Pull Request on Github is created. Also see Contributing Guidelines for this topic. We could also think about a PR template as suggested here.
Most of the content is copied from the developer space and some structure is inspired from puppet.