-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add initial project documentation (#1)
Setup initial documentation for this repository. Signed-off-by: Jim C. Nasby <nasbyj@amazon.com>
- Loading branch information
Showing
7 changed files
with
389 additions
and
26 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
File renamed without changes.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
PostgreSQL Database Management System | ||
(formerly known as Postgres, then as Postgres95) | ||
|
||
Portions Copyright (c) 1996-2021, PostgreSQL Global Development Group | ||
|
||
Portions Copyright (c) 1994, The Regents of the University of California | ||
|
||
Permission to use, copy, modify, and distribute this software and its | ||
documentation for any purpose, without fee, and without a written agreement | ||
is hereby granted, provided that the above copyright notice and this | ||
paragraph and the following two paragraphs appear in all copies. | ||
|
||
IN NO EVENT SHALL THE UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR | ||
DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING | ||
LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS | ||
DOCUMENTATION, EVEN IF THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE | ||
POSSIBILITY OF SUCH DAMAGE. | ||
|
||
THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY WARRANTIES, | ||
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY | ||
AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS | ||
ON AN "AS IS" BASIS, AND THE UNIVERSITY OF CALIFORNIA HAS NO OBLIGATIONS TO | ||
PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,94 @@ | ||
- [Overview](#overview) | ||
- [Current Maintainers](#current-maintainers) | ||
- [Maintainer Responsibilities](#maintainer-responsibilities) | ||
- [Uphold Code of Conduct](#uphold-code-of-conduct) | ||
- [Prioritize Security](#prioritize-security) | ||
- [Review Pull Requests](#review-pull-requests) | ||
- [Triage Open Issues](#triage-open-issues) | ||
- [Be Responsive](#be-responsive) | ||
- [Maintain Overall Health of the Repo](#maintain-overall-health-of-the-repo) | ||
- [Add Continious Integration Checks](#add-continious-integration-checks) | ||
- [Developer Certificate of Origin Workflow](#developer-certificate-of-origin-workflow) | ||
- [Use Semver](#use-semver) | ||
- [Release Frequently](#release-frequently) | ||
- [Promote Other Maintainers](#promote-other-maintainers) | ||
|
||
## Overview | ||
|
||
This document explains who the maintainers are (see below), what they do in this repo, and how they should be doing it. If you're interested in contributing, see [CONTRIBUTING](CONTRIBUTING.md). | ||
|
||
## Current Maintainers | ||
|
||
Initially, GitHub maintainers will be from within AWS: As we progress, we'll add additional external maintainers. Guidelines for adding external maintainers will be published. Current list of maintainers | ||
|
||
| Maintainer | GitHub ID | Affiliation | | ||
| ------------------------ | --------------------------------------- | ----------- | | ||
| Zane Li | [zli236](https://github.com/zli236) | Amazon | | ||
| Huansong Fu | [huansong](https://github.com/huansong) | Amazon | | ||
| Kuntal Ghosh | [slightst](https://github.com/slightst) | Amazon | | ||
| Di Wu | [macwoody](https://github.com/macwoody) | Amazon | | ||
| Korry Douglas | [korryd](https://github.com/korryd) | Amazon | | ||
| Suprio Pal | [suprio-amzn](https://github.com/suprio-amzn) | Amazon | | ||
| Jim Mlodgenski | [jim-mlodgenski](https://github.com/jim-mlodgenski) | Amazon | | ||
| Jim Nasby | [nasbyj](https://github.com/nasbyj) | Amazon | | ||
| Jim Finnerty | [JimFinnerty](https://github.com/JimFinnerty) | Amazon | | ||
| Rob VErschoor | [rcv-aws](https://github.com/rcv-aws) | Amazon | | ||
| Simon Lightstone | [slightst](https://github.com/slightst) | Amazon | | ||
| Richard Waymire | [waymire](https://github.com/waymire) | Amazon | | ||
| Gopinath Pai | [gopinathpai](https://github.com/gopinathpai)| Amazon | | ||
|
||
|
||
## Maintainer Responsibilities | ||
|
||
Maintainers are active and visible members of the community, and have [maintain-level permissions on a repository](https://docs.github.com/en/organizations/managing-access-to-your-organizations-repositories/repository-permission-levels-for-an-organization). Use those privileges to serve the community and evolve code as follows. | ||
|
||
### Uphold Code of Conduct | ||
|
||
Model the behavior set forward by the [Code of Conduct](CODE_OF_CONDUCT.md) and raise any violations to other maintainers and admins. | ||
|
||
### Prioritize Security | ||
|
||
Security is your number one priority. Maintainer's Github keys must be password protected securely and any reported security vulnerabilities are addressed before features or bugs. | ||
|
||
Note that this repository is monitored and supported 24/7 by Amazon Security, see [Reporting a Vulnerability](SECURITY.md) for details. | ||
|
||
### Review Pull Requests | ||
|
||
Review pull requests regularly, comment, suggest, reject, merge and close. Accept only high quality pull-requests. Provide code reviews and guidance on incomming pull requests. Don't let PRs be stale and do your best to be helpful to contributors. | ||
|
||
### Triage Open Issues | ||
|
||
Manage labels, review issues regularly, and triage by labelling them. | ||
|
||
All repositories in this organization have a standard set of labels, including `bug`, `documentation`, `duplicate`, `enhancement`, `good first issue`, `help wanted`, `blocker`, `invalid`, `question`, `wontfix`, and `untriaged`, along with release labels, such as `v1.0.0`, `v1.1.0`, `v2.0.0`, `patch`, and `backport`. | ||
|
||
Use labels to target an issue or a PR for a given release, add `help wanted` to good issues for new community members, and `blocker` for issues that scare you or need immediate attention. Request for more information from a submitter if an issue is not clear. Create new labels as needed by the project. | ||
|
||
### Be Responsive | ||
|
||
Respond to enhancement requests, and forum posts. Allocate time to reviewing and commenting on issues and conversations as they come in. | ||
|
||
### Maintain Overall Health of the Repo | ||
|
||
Keep the `main` branch at production quality at all times. Backport features as needed. Cut release branches and tags to enable future patches. | ||
|
||
### Add Continious Integration Checks | ||
|
||
Add integration checks that validate pull requests and pushes to ease the burden on Pull Request reviewers. | ||
|
||
#### Developer Certificate of Origin Workflow | ||
|
||
Validates pull requests commits are all signed with the doc, [doc.yml](./workflows/dco.yml). | ||
|
||
### Use Semver | ||
|
||
Use and enforce [semantic versioning](https://semver.org/) and do not let breaking changes be made outside of major releases. | ||
|
||
### Release Frequently | ||
|
||
Make frequent project releases to the community. | ||
|
||
### Promote Other Maintainers | ||
|
||
Assist, add, and remove [MAINTAINERS](MAINTAINERS.md). Exercise good judgement, and propose high quality contributors to become co-maintainers. | ||
|
Oops, something went wrong.