Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 3.17 KB

Sandbox_Annual_Review.md

File metadata and controls

37 lines (25 loc) · 3.17 KB
Raw

Sandbox Annual Review

Sandbox projects are subject to an annual review by the IDSA-TSC. This is intended to be a lightweight process to ensure that projects are on track, and getting the support they need.

To keep it lightweight, it is a single phase process - the review doesn't first pass through IDSA WGs and then the IDSA-TSC. The review document is shared with the community and WG members can comment on each review, as can any other TSC contributor. The intention is to quickly reach a position where TSC members agree to continue sponsorship.

How to file your annual review?

IDSA staff will notify the project maintainers when the project review is due.

Project maintainers are responsible for agreeing between them who will complete the annual review. One of the maintainers should create the review in GitHub under Sanbox_Reviews.

  • Raise a PR titled [Project name] [year] Annual Review
  • The PR should include a file called --annual.md (for example, 2022-amazingproj-annual.md) with the contents described below
  • Send an email to the TSC Chair so that the community knows the PR is there and can comment on it

If your annual review isn’t submitted within two months of notification, we will take this as a sign that the project is not under active maintenance and the TSC is likely to decide to archive the project.

Review outcomes

The outcome of the annual review is either:

  • At least three TSC members agree to continue to sponsor the project in Sandbox, or
  • If enough TSC members don’t agree to continue to sponsor the project, we will discuss archiving or other next steps with you.

Additionally, the TSC might recommend that you apply for Incubation stage. This requires extra work and due diligence so it’s not a possible outcome directly from this lightweight annual review.

It is fine for projects to stay in the Sandbox indefinitely while it is still active, but if a project has genuinely stalled we can save everyone’s effort by archiving it.

Annual review contents

Your annual review should answer the following questions:

  • Include a link to your project’s devstats page. We will be looking for signs of consistent or increasing contribution activity. Please feel free to add commentary to add colour to the numbers and graphs we will see on devstats.
  • How many maintainers do you have, and which organizations are they from? (Feel free to link to an existing MAINTAINERS file if appropriate.)
  • What do you know about adoption, and how has this changed since your last review / since you joined Sandbox? If you can list companies that are end users of your project, please do so. (Feel free to link to an existing ADOPTERS file if appropriate.)
  • How has the project performed against its goals since the last review? (We won't penalize you if your goals changed for good reasons.)
  • What are the current goals of the project? For example, are you working on major new features? Or are you concentrating on adoption or documentation?
  • How can the IDSA help you achieve your upcoming goals?
  • Do you think that your project meets the criteria for incubation?