Skip to content

Commit c19f2b7

Browse files
committed
add third party contributions doc
1 parent 20eb10a commit c19f2b7

File tree

1 file changed

+35
-0
lines changed

1 file changed

+35
-0
lines changed

THIRD-PARTY-CONTRIBUTIONS.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Guidelines for Contributing a 3rd Party Library
2+
3+
### Code of Conduct
4+
* Anyone contributing to any of the projects in the Steeltoe portfolio, including Steeltoe Initializr, must adhere to our [Contributor Guidelines](https://github.com/SteeltoeOSS/steeltoe#contributing) and [Governance Model](https://github.com/SteeltoeOSS/steeltoe#governance-model).
5+
### Open sourced and available on NuGet.org
6+
* The library must be open sourced and available on [NuGet.org](https://nuget.org).
7+
* The library must be made available with an appropriate OSS license which is deemed compatible with the Apache 2.0 license
8+
### Community
9+
* There should be a sizeable community, or an established organization, that is actively using and maintaining the library
10+
* An available support forum and a public issue tracker
11+
### Package Metadata and Documentation
12+
* The NuGet library should (at a minimum) have these package metadata entries (MSBuild Package Property Names):
13+
* PackageId
14+
* PackageVersion
15+
* Authors
16+
* Company
17+
* Title
18+
* Description/PackageDescription
19+
* Copyright
20+
* PackageProjectUrl
21+
* PackageLicenseFile or PackageLicenseUrl
22+
* PackageReleaseNotes
23+
* RepositoryUrl
24+
* RepositoryBranch
25+
* For each library on start.steeltoe.io, documentation must be publicly available at the project’s url or on the project’s repository.
26+
* Documentation should indicate which versions of .NET Core and Steeltoe are supported
27+
### Other Dependencies:
28+
* The 3rd party library should not bring in any supporting dependencies that aren’t compatible with the Apache 2.0 license
29+
* All of these supporting dependencies must be available on NuGet.org
30+
### Test Coverage:
31+
* The 3rd party library should have proper test coverage that validates it works properly with supported Steeltoe versions
32+
### Steeltoe Engineering Review:
33+
* The Steeltoe team will periodically review usage statistics (i.e. NuGet downloads, project activity, etc.) and may decide to remove 3rd party libraries from start.steeltoe.io if they are not being used.
34+
* The Steeltoe team will periodically check that a 3rd party library is still being supported and that the project is actively releasing updates. If it is determined to no longer or minimally active project, the library will be identified for removal.
35+
* Even if these requirements are met, the Steeltoe team may decide that a proposed 3rd party starter does not meet the strategic direction of Steeltoe and the overall portfolio. In this case, it’s still possible to create and share a 3rd party NuGet package but they will not be listed on start.steeltoe.io.

0 commit comments

Comments
 (0)