This commit is contained in:
Ben McMorran 2021-05-12 13:51:27 -07:00 коммит произвёл GitHub
Родитель 13e32e7824
Коммит 140672c4f9
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
2 изменённых файлов: 51 добавлений и 0 удалений

11
CONTRIBUTING.md Normal file
Просмотреть файл

@ -0,0 +1,11 @@
# Contributing
**Public pull requests are not accepted to this repo.** If you would like to
contribute changes to OpenOCD, please contribute directly to upstream following
the [OpenOCD Developer's Guide](http://openocd.org/doc/doxygen/html/index.html).
This project has adopted the [Microsoft Open Source Code of Conduct](
https://opensource.microsoft.com/codeofconduct/). For more information see the
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any
additional questions or comments.

40
README.md Normal file
Просмотреть файл

@ -0,0 +1,40 @@
# Microsoft's fork of OpenOCD
**Public pull requests are not accepted to this repo.** If you would like to
contribute changes to OpenOCD, please contribute directly to upstream following
the [OpenOCD Developer's Guide](http://openocd.org/doc/doxygen/html/index.html).
This is a soft fork of the [OpenOCD project](http://openocd.org/) where
Microsoft stages changes and provides binaries for Windows and Linux. The Linux
binaries are statically linked with [musl](https://www.musl-libc.org/) and are
highly portable across a wide range of Linux distributions. In addition, this
fork incorporates changes from
[Raspberry Pi](https://github.com/raspberrypi/openocd),
[STMicroelectronics](https://github.com/STMicroelectronics/OpenOCD), and [Azure
Sphere](https://thirdpartysource.microsoft.com/) to improve compatibility with
the embedded development ecosystem.
This project has adopted the [Microsoft Open Source Code of Conduct](
https://opensource.microsoft.com/codeofconduct/). For more information see the
[Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any
additional questions or comments.
## Branching strategy
The `master` branch mirrors `master` in the upstream repository and is updated
whenever OpenOCD releases. The `microsoft/main` branch follows `master` and
includes small additions like this README and the scripts required to produce
statically linked Linux binaries.
After every upstream tagged OpenOCD release, a new branch of the form
`microsoft/rel/<version>` will be created based on `microsoft/main`. Patches
from the Raspberry Pi, STMicroelectronics, and Azure Sphere forks will be
applied to this new branch. After validating the build, the tip of the branch
will be tagged as `ms-v<version>` and added as a
[release](https://github.com/microsoft/openocd/releases). Because OpenOCD
releases are infrequent, it's more likely that the vendor forks and OpenOCD
itself will have significant changes in the time between releases. Patches are
are not applied directly to `microsoft/main` to avoid merge conflicts from stale
vendor fork changes. Vendors are also encouraged to contribute their changes to
upstream OpenOCD to avoid the need for patches at all.