From 871a9fb0c68b91c892204946f0a0f291601026e9 Mon Sep 17 00:00:00 2001 From: Ryan Richard Date: Fri, 27 Aug 2021 15:52:51 -0700 Subject: [PATCH] Simplify the main README.md to reduce duplication with website --- CONTRIBUTING.md | 23 +++++++++++++-- README.md | 78 +++++++++++++++++++++---------------------------- 2 files changed, 53 insertions(+), 48 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1229a6e9..3192ed45 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,15 +10,28 @@ Please see the [Code of Conduct](./CODE_OF_CONDUCT.md). See [SCOPE.md](./SCOPE.md) for some guidelines about what we consider in and out of scope for Pinniped. +## Roadmap + +The near-term and mid-term roadmap for the work planned for the project [maintainers](MAINTAINERS.md) is documented in [ROADMAP.md](ROADMAP.md). + ## Community Meetings -Pinniped is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings, occuring every first and third Thursday of the month at 9AM PT / 12PM ET. Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) to attend and add any agenda items you wish to discuss to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). Join our [Google Group](https://groups.google.com/u/1/g/project-pinniped) to receive invites to this meeting. +Pinniped is better because of our contributors and [maintainers](MAINTAINERS.md). It is because of you that we can bring great +software to the community. Please join us during our online community meetings, +occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT. +Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) +to attend and add any agenda items you wish to discuss +to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). +Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting. If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled. ## Discussion -Got a question, comment, or idea? Please don't hesitate to reach out via the GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions) tab at the top of this page or reach out in Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA). +Got a question, comment, or idea? Please don't hesitate to reach out +via GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions), +GitHub [Issues](https://github.com/vmware-tanzu/pinniped/issues), +or in the Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA). ## Issues @@ -45,7 +58,7 @@ guidelines in the issue and pull request templates. To suggest a feature, please first open an [issue](https://github.com/vmware-tanzu/pinniped/issues/new?template=feature-proposal.md) and tag it with `proposal`, or create a new [Discussion](https://github.com/vmware-tanzu/pinniped/discussions). -The project team will work with you on your feature request. +The project [maintainers](MAINTAINERS.md) will work with you on your feature request. Once the feature request has been validated, a [pull request](https://github.com/vmware-tanzu/pinniped/compare) can be opened to implement the feature. @@ -53,6 +66,10 @@ can be opened to implement the feature. For specifics on what to include in your feature request, please follow the guidelines in the issue and pull request templates. +### Reporting security vulnerabilities + +Please follow the procedure described in [SECURITY.md](SECURITY.md). + ## CLA We welcome contributions from everyone but we can only accept them if you sign diff --git a/README.md b/README.md index ca7df8dd..08222e66 100644 --- a/README.md +++ b/README.md @@ -1,63 +1,51 @@ -Pinniped Logo + + Pinniped Logo + ## Overview Pinniped provides identity services to Kubernetes. -Pinniped allows cluster administrators to easily plug in external identity -providers (IDPs) into Kubernetes clusters. This is achieved via a uniform -install procedure across all types and origins of Kubernetes clusters, -declarative configuration via Kubernetes APIs, enterprise-grade integrations -with IDPs, and distribution-specific integration strategies. +- Easily plug in external identity providers into Kubernetes clusters while offering a simple install and configuration experience. Leverage first class integration with Kubernetes and kubectl command-line. +- Give users a consistent, unified login experience across all your clusters, including on-premises and managed cloud environments. +- Securely integrate with an enterprise IDP using standard protocols or use secure, externally managed identities instead of relying on simple, shared credentials. -### Example use cases - -* Your team uses a large enterprise IDP, and has many clusters that they - manage. Pinniped provides: - * Seamless and robust integration with the IDP - * Easy installation across clusters of any type and origin - * A simplified login flow across all clusters -* Your team shares a single cluster. Pinniped provides: - * Simple configuration to integrate an IDP - * Individual, revocable identities - -### Architecture - -The Pinniped Supervisor component offers identity federation to enable a user to -access multiple clusters with a single daily login to their external IDP. The -Pinniped Supervisor supports various external [IDP -types](https://github.com/vmware-tanzu/pinniped/tree/main/generated/1.20#k8s-api-idp-supervisor-pinniped-dev-v1alpha1). - -The Pinniped Concierge component offers credential exchange to enable a user to -exchange an external credential for a short-lived, cluster-specific -credential. Pinniped supports various [authentication -methods](https://github.com/vmware-tanzu/pinniped/tree/main/generated/1.20#authenticationconciergepinnipeddevv1alpha1) -and implements different integration strategies for various Kubernetes -distributions to make authentication possible. - -The Pinniped Concierge can be configured to hook into the Pinniped Supervisor's -federated credentials, or it can authenticate users directly via external IDP -credentials. - -To learn more, see [architecture](https://pinniped.dev/docs/background/architecture/). +To learn more, please visit the Pinniped project's website, https://pinniped.dev. ## Getting started with Pinniped Care to kick the tires? It's easy to [install and try Pinniped](https://pinniped.dev/docs/). -## Community meetings - -Pinniped is better because of our contributors and maintainers. It is because of you that we can bring great software to the community. Please join us during our online community meetings, occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT. Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) to attend and add any agenda items you wish to discuss to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting. - -If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled. - ## Discussion -Got a question, comment, or idea? Please don't hesitate to reach out via the GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions) tab at the top of this page or reach out in Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA). +Got a question, comment, or idea? Please don't hesitate to reach out +via GitHub [Discussions](https://github.com/vmware-tanzu/pinniped/discussions), +GitHub [Issues](https://github.com/vmware-tanzu/pinniped/issues), +or in the Kubernetes Slack Workspace within the [#pinniped channel](https://kubernetes.slack.com/archives/C01BW364RJA). ## Contributions -Contributions are welcome. Before contributing, please see the [contributing guide](CONTRIBUTING.md). +Want to get involved? Contributions are welcome. + +Please see the [contributing guide](CONTRIBUTING.md) for more information about reporting bugs, requesting features, +building and testing the code, submitting PRs, and other contributor topics. + +## Community meetings + +Pinniped is better because of our contributors and [maintainers](MAINTAINERS.md). It is because of you that we can bring great +software to the community. Please join us during our online community meetings, +occurring every first and third Thursday of the month at 9 AM PT / 12 PM PT. +Use [this Zoom Link](https://vmware.zoom.us/j/93798188973?pwd=T3pIMWxReEQvcWljNm1admRoZTFSZz09) +to attend and add any agenda items you wish to discuss +to [the notes document](https://hackmd.io/rd_kVJhjQfOvfAWzK8A3tQ?view). +Join our [Google Group](https://groups.google.com/g/project-pinniped) to receive invites to this meeting. + +If the meeting day falls on a US holiday, please consider that occurrence of the meeting to be canceled. + +## Adopters + +Some organizations and products using Pinniped are featured in [ADOPTERS.md](ADOPTERS.md). +Add your own organization or product [here](https://github.com/vmware-tanzu/pinniped/discussions/152). ## Reporting security vulnerabilities @@ -67,4 +55,4 @@ Please follow the procedure described in [SECURITY.md](SECURITY.md). Pinniped is open source and licensed under Apache License Version 2.0. See [LICENSE](LICENSE). -Copyright 2020 the Pinniped contributors. All Rights Reserved. +Copyright 2020-2021 the Pinniped contributors. All Rights Reserved.