Skip to content
This repository has been archived by the owner on Jul 29, 2021. It is now read-only.

Expand requirements with the reason why it is a good practice #30

Open
JamesNK opened this issue Sep 27, 2019 · 0 comments
Open

Expand requirements with the reason why it is a good practice #30

JamesNK opened this issue Sep 27, 2019 · 0 comments

Comments

@JamesNK
Copy link
Member

JamesNK commented Sep 27, 2019

Today the model just lists what is required at each level. It is easy for someone to look at the requires as a list of work to do with no benefit to themselves or the project. Or to frame the requirements as "the .NET Foundation is pushing an enterprise agenda on OSS devs".

You should expand the requirements to give a reason for why an OSS project should do this, and include the benefit to the maintainer, e.g.

✔️ Project uses the .NET Foundation CLA bot

Setting up the CLA bot will ensure all contributors have accepted your projects copyright. It will protect the project and you as the maintainer against awful legal thing X and Y.

✔️ Roadmap is documented, via formal document and/or an issue query.

One of the most common questions to a project maintainer is when will the next release be. A roadmap lets users find out for themselves, reducing your workload.

✔️ Build scripts are documented and can be readily used by consumers.

Documented build scripts will help new developers build the project. This is helpful for new contributors, and developers who want to debug an issue for themselves.

etc

The .NET OSS library guidance follows this pattern and I think it has worked very well - https://docs.microsoft.com/en-us/dotnet/standard/library-guidance/cross-platform-targeting

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant