Skip to content

Commit

Permalink
add RFC4
Browse files Browse the repository at this point in the history
  • Loading branch information
tomkralidis committed Mar 2, 2024
1 parent 76b214a commit 3be8039
Show file tree
Hide file tree
Showing 2 changed files with 58 additions and 0 deletions.
56 changes: 56 additions & 0 deletions docs/development/rfc/4.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
title: RFC4 - GitHub Issue and Pull Request management
---

# RFC4 - GitHub Issue and Pull Request management

- date: 2024-03-01
- author: Tom Kralidis
- contact: [email protected]
- status: draft
- modified: 2024-03-02

## Summary

This RFC describes the policies and procedures for handling pygeoapi GitHub Issues and Pull Requests (PRs).

## Issue and PR management

From a software management perspective, the pygeoapi project is managed on GitHub, which includes the following:

- source code / version control (software, documentation)
- Issues (bugs, feature enhancements, etc), milestones and triage
- Pull Requests
- wiki
- milestones

Given the free and open-source nature and spirit of the project, contributions are enabled and encouraged. To
efficiently manage the above elements in the context of the pygeoapi PSC, committers and collaborators,
it is proposed to put forth clear principles for handling GitHub contributions.

## Key principles

- contributions to (new features, bugs, documentation, testing) are encouraged and greatly appreciated
- non-trivial contributions in the form of Pull Requests are best put forth in the context of an Issue, so that discussion
can take place to identify any possible concerns or impacts
- pygeoapi PSC, committers and collaborators are able to triage and collaborate on Issues and Pull Requests in a timely
fashion
- over time, it is normal that Issues may be without activity for any given reason

## Implementation

To efficiently manage pygeoapi Issues and Pull Requests and to maintain a healthy and sustainable enviroment for pygeoapi
PSC, committers and collaborators, the following implementation is proposed:

- all Issues and Pull Requests shall be at least addressed (triaged or commented on) within ten (10) business days (assuming working days Monday - Friday)
- Issues or Pull Requests with more than ninety (90) days of inactivity shall receive an automated update to the issue with
a warning that the Issue or Pull Request will be automatically closed in 7 days
- Issues with a label of `blocker` shall not be closed under any circumstance
- automated updates shall be run on a weekly basis
- GitHub Issue Templates shall be updated as follows:
- reminding the submitter that the Issue or Pull Request is subject to the above policies and procedures
- encouraging and guiding the submitter that a given Pull Request should be based on an issue

## Voting History

TBD
2 changes: 2 additions & 0 deletions docs/development/rfc/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,5 @@ the project.

* [RFC1: Project Steering Committee Guidelines](1)
* [RFC2: Dependency policy](2)
* [RFC3: Architectural Decision Records](3)
* [RFC4: GitHub Issue and Pull Request management](4)

0 comments on commit 3be8039

Please sign in to comment.