begriffs open source - cmsis-dfp-stm32f4/blob - CONTRIBUTING.md

   1 ## Contributing guide
   2 This document serves as a checklist before contributing to this repository.
   3 It includes links to read up on if topics are unclear to you.
   4
   5 This guide mainly focuses on the proper use of Git.
   6
   7 ### 1. Before opening an issue
   8 To report a bug/request please file an issue in the right repository
   9 (example for [cmsis_device_f4](https://github.com/STMicroelectronics/cmsis_device_f4/issues/new/choose)).
  10 But check the following boxes before posting an issue:
  11
  12 - [ ] `Make sure you are using the latest commit (major releases are Tagged, but corrections are available as new commits).`
  13 - [ ] `Make sure your issue is a question/feedback/suggestions RELATED TO the software provided in this repo.` Otherwise, it should be discussed on the [ST Community/STM32 MCUs forum](https://community.st.com/s/group/0F90X000000AXsASAW/stm32-mcus).
  14 - [ ] `Make sure your issue is not already reported/fixed on GitHub or discussed on a previous Issue.` Please refer to this [dashboard](https://github.com/orgs/STMicroelectronics/projects/2) for the list of issues and pull-requests. Do not forget to browse into the **closed** issues.
  15
  16
  17 ### 2. Posting the issue
  18 When you have checked the previous boxes. You will find two templates Issues (Bug Report or Other Issue) available in the **Issues** tab of the repo
  19
  20 ### 3. Pull Requests
  21 STMicrolectronics is happy to receive contributions from the community, based on an initial Contributor License Agreement (CLA) procedure.
  22
  23 **From April 7th 2020**
  24
  25 * 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)
  26 * If you work for a company that wants also to allow you to contribute your work, your company needs to provide a Corporate CLA (https://cla.st.com) mentioning your GitHub account name
  27 * If you’re not sure that a CLA (Individual or Corporate) has been signed for your GitHub account you can check here (https://cla.st.com). Please note that Corporate CLA will always take precedence over Individual CLA
  28
  29 One CLA submition is sufficient, for any project proposed by STMicroelectronics
  30
  31 #### How to proceed
  32
  33 * We recommend to engage first a communication thru an **Issue**, in order to present your proposal. Just to confirm that it correspond to STMicroelectronics domain or scope.
  34 * Then fork the project in your GitHub account to further develop your contribution. Please use the latest commit version.
  35 * Please, submit one Pull Request for one new feature or proposal. This will ease the analysis and final merge if accepted