OrgST-Microelectronics
/
STM32CubeF1
mirror of https://github.com/STMicroelectronics/STM32CubeF1.git
1
0
Fork 0
Code Issues Releases Wiki Activity
STM32CubeF1/CONTRIBUTING.md

41 lines
2.6 KiB
Markdown
Raw Permalink Normal View History

[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
# Contributing guide
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
This guide serves as a checklist before contributing to this repository. It mainly focuses on the steps to follow to submit an issue or a pull-request.
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
## 1. Issues
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
### 1.1 Before opening an issue
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
Please check the following points before posting an issue:
* Make sure you are using the latest commit (major releases are tagged, but corrections are available as new commits).
* Make sure your issue is a question/feedback/suggestions **related to** the software provided in this repository. Otherwise, please refer to section [3](CONTRIBUTING.md#3-support-requests-and-questions) below.
* Make sure your issue is not already reported/fixed on GitHub or discussed on a previous issue. Do not forget to browse into the **closed** issues.
### 1.2 Posting the issue
When you have checked the previous points, create a new report from the **Issues** tab of this repository. A template is available [here](../../issues/new/choose) to help you report the issue you are facing or the enhancement you would like to propose.
## 2. Pull Requests
### 2.1 Before opening a pull-request
Release v1.8.0
2019-07-05 21:33:16 +08:00
Update CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md with CLA procedure description and mention that pull-requests are now accepted
2020-03-26 17:32:27 +08:00
STMicrolectronics is happy to receive contributions from the community, based on an initial Contributor License Agreement (CLA) procedure.
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
* If you are an individual writing original source code and you are sure **you own the intellectual property**, then you need to sign an Individual [CLA](https://cla.st.com).
* If you work for a company that wants also to allow you to contribute with your work, your company needs to provide a Corporate [CLA](https://cla.st.com) mentioning your GitHub account name.
* If you are not sure that a CLA (Individual or Corporate) has been signed for your GitHub account you can check the [CLA](https://cla.st.com) dedicated page.
Update CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md with CLA procedure description and mention that pull-requests are now accepted
2020-03-26 17:32:27 +08:00
Please note that:
* The Corporate CLA will always take precedence over the Individual CLA.
* One CLA submission is sufficient, for any project proposed by STMicroelectronics.
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
### 2.2 How to proceed
Release v1.8.0
2019-07-05 21:33:16 +08:00
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
* We recommend to engage first a communication thru an issue, in order to present your proposal, just to confirm that it corresponds to STMicroelectronics' domain or scope.
Update CONTRIBUTING.md and PULL_REQUEST_TEMPLATE.md with CLA procedure description and mention that pull-requests are now accepted
2020-03-26 17:32:27 +08:00
* Then fork the project to your GitHub account to further develop your contribution. Please use the latest commit version.
[PRJ] Remove projects using MW libraries subject to click-thru Rationale: - MW libraries subject to click-thru have been already removed from this repo, but not the projects using them. - Building these projects, whether manually or automatically via some ACI tool would yield errors. - Particularly with daily (or nightly) builds in the frame of a CI/CD strategy, such errors would pollute the logs uselessly. Note: If needed, the removed items can be found in the full firmware package on st.com. Please refer to the README.md file for further details.
2022-12-16 21:54:17 +08:00
* Please, submit one pull-request per new feature or proposal. This will ease the analysis and the final merge if accepted.
## 3. Support requests and questions
For support requests or any other question related to the product, the tools, the environment, you can submit a post to the **ST Community** on the appropriate topic [page](https://community.st.com/s/topiccatalog).