Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HoldTillRename: Rename knative-sandbox to knative-extension #1361

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 10 additions & 10 deletions .github/ISSUE_TEMPLATE/new-repo.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
---
name: Request a new repo
about: Request creation of a new repo in the knative or knative-sandbox orgs
about: Request creation of a new repo in the knative or knative-extension orgs
title: "New Repo: `$REPONAME`"
---

Use this issue type to request a new repo in `knative-sandbox` (or
Use this issue type to request a new repo in `knative-extension` (or
`knative`, which may require additional discussion).

<!-- Update the information below with your request -->

## Repo information

Org: `knative-sandbox`
Org: `knative-extension`

Repo: `$REPONAME`

Expand All @@ -31,7 +31,7 @@ The TOC is involved only in the **TOC Gate** steps.

_You may not be able to use the Projects quick menu on this page. In that case, go to the project board and use the **Add cards** interface._

- [ ] Send a PR adding entries for this repo in [`/peribolos/knative-sandbox.yaml`](https://github.com/knative/community/blob/main/peribolos/knative-sandbox.yaml). Please mind the alphabetical order when adding to a list.
- [ ] Send a PR adding entries for this repo in [`/peribolos/knative-extension.yaml`](https://github.com/knative/community/blob/main/peribolos/knative-extension.yaml). Please mind the alphabetical order when adding to a list.
- [ ] Add the repository and a description.
- [ ] Grant `Knative Admin` the `admin` privilege.
- [ ] Grant the sponsoring WG the `write` privilege.
Expand All @@ -43,15 +43,15 @@ _You may not be able to use the Projects quick menu on this page. In that case,
- [ ] (golang) Send a PR to add aliases for `knative.dev/$REPONAME` import paths ([sample](https://github.com/knative/docs/pull/4160)).

- [ ] Have a lead from the sponsoring WG bootstrap the Git repository by pushing an
appropriate "template" repository ([basic](https://github.com/knative-sandbox/wg-repository),
[sample-controller](https://github.com/knative-sandbox/sample-controller),
[sample-source](https://github.com/knative-sandbox/sample-source)) to the new repository as
appropriate "template" repository ([basic](https://github.com/knative-extension/wg-repository),
[sample-controller](https://github.com/knative-extension/sample-controller),
[sample-source](https://github.com/knative-extension/sample-source)) to the new repository as
a git remote. For example:

```shell
git clone https://github.com/knative-sandbox/sample-controller.git
git clone https://github.com/knative-extension/sample-controller.git
cd sample-controller
git remote add newrepo https://github.com/knative-sandbox/$REPONAME.git
git remote add newrepo https://github.com/knative-extension/$REPONAME.git
git push newrepo main
```

Expand All @@ -66,4 +66,4 @@ _You may not be able to use the Projects quick menu on this page. In that case,
- [ ] Verify that within 24 hours the appropriate branch protections have been applied
requiring `tide` to pass before PRs are merged.

- [ ] (optional) Send a PR adding the repo to [knobots](https://github.com/knative-sandbox/knobots).
- [ ] (optional) Send a PR adding the repo to [knobots](https://github.com/knative-extension/knobots).
4 changes: 2 additions & 2 deletions .github/workflows/peribolos-schema-validate.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,5 +32,5 @@ jobs:
- run: pip install strictyaml
- name: Validate knative.yaml
run: python3 peribolos/validate-schema.py peribolos/knative.yaml
- name: Validate knative-sandbox.yaml
run: python3 peribolos/validate-schema.py peribolos/knative-sandbox.yaml
- name: Validate knative-extension.yaml
run: python3 peribolos/validate-schema.py peribolos/knative-extension.yaml
2 changes: 1 addition & 1 deletion .github/workflows/verify.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@

# This file is **********NOT********** automagically synced here by knobots
# because its too hard to opt-in to a single action. See
# https://github.com/knative-sandbox/knobots/pull/99 for a potential solution.
# https://github.com/knative-extension/knobots/pull/99 for a potential solution.

name: Verify

Expand Down
14 changes: 7 additions & 7 deletions REPOSITORY-GUIDELINES.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,23 +96,23 @@ repository is retired and no longer maintained.

It is beneficial for Knative working groups to be able to own code outside the
core `knative` organization, which is kept intentionally small and has a high
bar for entry. The `knative-sandbox` GitHub organization was created for this
purpose. Repositories in `knative-sandbox` are intended to give working groups
bar for entry. The `knative-extension` GitHub organization was created for this
purpose. Repositories in `knative-extension` are intended to give working groups
more latitude to experiment with new ideas and to self-organize and manage
contributions which may be important to the project but which do not need the
level of governance of the core project.

Note that `knative-sandbox` is **not** an incubation area for projects entering
Note that `knative-extension` is **not** an incubation area for projects entering
the `knative` github org; in most cases, projects in the sandbox will remain
there for the entire duration. `knative-sandbox` also provides a location for
there for the entire duration. `knative-extension` also provides a location for
implementations of core interfaces which do not themselves need to be part of
every knative installation, such as networking or eventing integrations. In the
event that a working group wants a project in sandbox to be considered for
transfer to the `knative` org, the request will be considered on a case-by-case
basis by joint decision of the Steering Committee and the Technical Oversight
Committee.

### Mechanics of working-group owned repositories in `knative-sandbox`
### Mechanics of working-group owned repositories in `knative-extension`

#### Creation

Expand Down Expand Up @@ -189,7 +189,7 @@ The following are not required to create a working-group-owned repository:
### The fine print

Steering and Trademark reserve the right to require that repos be removed or
transferred out of the `knative-sandbox` organization and API groups to be
transferred out of the `knative-extension` organization and API groups to be
renamed. This is intended to simplify the process in the common case, while
giving Steering or Trademark the ability to step in and rectify problems that
may arise.
Expand All @@ -198,7 +198,7 @@ may arise.

Working groups are responsible for the upkeep of their repositories and are
expected to keep a high quality bar. Inactive or non-conforming repositories
should be archived, deleted, or moved out of the `knative-sandbox` organization,
should be archived, deleted, or moved out of the `knative-extension` organization,
following the general [Procedure for Removal](#procedure-for-removal) for
repositories.

Expand Down
4 changes: 2 additions & 2 deletions ROLES.md
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ table describes:

</table>

Please note that repos in the knative-sandbox GitHub org are a reflection of the WG leads. These leads are free to use their judgement to set the bar for what is required to become an approver and/or owner for knative-sandbox repos they are responsible for.
Please note that repos in the knative-extension GitHub org are a reflection of the WG leads. These leads are free to use their judgement to set the bar for what is required to become an approver and/or owner for knative-extension repos they are responsible for.

## Member

Expand All @@ -137,7 +137,7 @@ this is not a requirement.

- Member of the Knative github org. Create a PR adding you to
[knative.yaml](../main/peribolos/knative.yaml) and/or to
[knative-sandbox.yaml](../main/peribolos/knative-sandbox.yaml) which after when
[knative-extension.yaml](../main/peribolos/knative-extension.yaml) which after when
merged will send you an invite that you have to accept to become a member
of these organizations.

Expand Down
2 changes: 1 addition & 1 deletion hack/update-codegen.sh
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ function make_aliases() {
( cd mechanics/tools/gen-aliases; go build . )
# Auto-generate OWNERS_ALIASES from peribolos configs
./mechanics/tools/gen-aliases/gen-aliases knative peribolos/knative.yaml peribolos/knative-OWNERS_ALIASES
./mechanics/tools/gen-aliases/gen-aliases knative-sandbox peribolos/knative-sandbox.yaml peribolos/knative-sandbox-OWNERS_ALIASES
./mechanics/tools/gen-aliases/gen-aliases knative-extension peribolos/knative-extension.yaml peribolos/knative-extension-OWNERS_ALIASES
# Clean up the tool so we don't try to check it in.
rm ./mechanics/tools/gen-aliases/gen-aliases
}
Expand Down
16 changes: 8 additions & 8 deletions mechanics/CREATING-A-SANDBOX-REPO.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,17 +11,17 @@ may need to look there, too. -->

# Background

The [`knative-sandbox`](https://github.com/knative-sandbox) GitHub org exists to
The [`knative-extension`](https://github.com/knative-extension) GitHub org exists to
hold "non-core" Knative components which are owned and sponsored by a Working
Group. See the [Knative Repository Guidelines](../REPOSITORY-GUIDELINES.md) for
more details on the requirements for the `knative-sandbox` org.
more details on the requirements for the `knative-extension` org.

## Criteria

A Working Group Lead (either
[technical](../ROLES.md#working-group-technical-lead) or
[execution](../ROLES.md#working-group-execution-lead)) may request a new repo in
`knative-sandbox` by filing an issue in the
`knative-extension` by filing an issue in the
[knative/community](https://github.com/knative/community/issues/new?template=new-repo.md)
repo. Once filed, the TOC should handle these promptly, though it should also be
considered fine to ping members or the group on Slack if it hasn't been acted on
Expand All @@ -38,18 +38,18 @@ other WGs to review and approve impacting changes.
copyright holders under an Apache 2.0 license. See also
[this section of the repository guidelines](../REPOSITORY-GUIDELINES.md#creation).

- Names between `knative-sandbox` and the main `knative` repo should not
- Names between `knative-extension` and the main `knative` repo should not
overlap. This simplifies promoting repos between the two orgs and setting up
`knative.dev` import paths for golang.

- Prow automation for tests is encouraged but not required for
`knative-sandbox`, but the Google CLA bot and OWNERS files/tide merge should
`knative-extension`, but the Google CLA bot and OWNERS files/tide merge should
be enforced.

## Process (to be executed by TOC or Steering member)

1. (Requires Org owner) Create the new repo in
https://github.com/knative-sandbox using the "New" button. Set the repo to
https://github.com/knative-extension using the "New" button. Set the repo to
public and include an "Apache License 2.0" but no `.gitignore` or `README`.

1. (Requires repo write/org owner) Create:
Expand All @@ -66,7 +66,7 @@ other WGs to review and approve impacting changes.
`CODE-OF-CONDUCT.md`, and `README.md`

1. Add entries for the repo to
[`../peribolos/knative-sandbox.yaml` in knative/community](https://github.com/knative/community/peribolos/knative-sandbox.yaml).
[`../peribolos/knative-extension.yaml` in knative/community](https://github.com/knative/community/peribolos/knative-extension.yaml).
As part of this, grant one or more sponsoring WGs the "write" permission on
the repo ([sample PR](https://github.com/knative/community/pull/170))

Expand All @@ -83,7 +83,7 @@ other WGs to review and approve impacting changes.

1. Ensure that Prow is working correctly by creating a PR against the repo. One
good way to do this is to
[add a `test/presubmit-tests.sh`](https://github.com/knative-sandbox/discovery/pull/1)
[add a `test/presubmit-tests.sh`](https://github.com/knative-extension/discovery/pull/1)
via either the web UI or using a fork.

1. Once at least one PR has been created, you'll be able to select the branch
Expand Down
8 changes: 4 additions & 4 deletions mechanics/MATURITY-LEVELS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Knative Migration-To-Core Process

This document provides a maturity model for projects in the Knative community.
This includes projects in knative-sandbox (broader community) or as well as
This includes projects in knative-extension (broader community) or as well as
projects in other GitHub organizations which wish to participate in the
community process. It also defines a process for
[migrating community projects into the Knative core](#migration-to-core), if
Expand All @@ -22,7 +22,7 @@ are not in the core may be equally valuable and production-worthy.

In the initiating phase, a project is starting up, and may have minimal
additional artifacts around the code itself. The minimum bar for an initiating
project in the knative-sandbox org is:
project in the knative-extension org is:

- [Adopted the CLA bot and OWNERS file / Tide merge process](https://github.com/knative/community/blob/master/mechanics/CREATING-A-SANDBOX-REPO.md#technical-requirements),
to ensure IP ownership
Expand All @@ -42,9 +42,9 @@ This phase is suitable for:
- Templates
- etc

Note that Initiating projects do not need to be hosted in knative-sandbox, and
Note that Initiating projects do not need to be hosted in knative-extension, and
can be hosted under either individual accounts or in other orgs. For projects in
knative-sandbox, review requirements and cadence are at the discretion of the
knative-extension, review requirements and cadence are at the discretion of the
sponsoring WG lead.

## Usable
Expand Down
4 changes: 2 additions & 2 deletions mechanics/ROADMAPS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Overview

All [working groups](../working-groups/WORKING-GROUPS.md) should maintain a current and up-to-date roadmap in a GitHub Project. It's recommended that a _single org-level project_ in the `knative` org should be used; for linking to issues in `knative-sandbox`, cards with the URL of the sandbox issue can be used.
All [working groups](../working-groups/WORKING-GROUPS.md) should maintain a current and up-to-date roadmap in a GitHub Project. It's recommended that a _single org-level project_ in the `knative` org should be used; for linking to issues in `knative-extension`, cards with the URL of the sandbox issue can be used.

Working Groups should link to their roadmaps in the Working Group documentation, and should work off the roadmap on a week-to-week or month-to-month basis.

Expand Down Expand Up @@ -62,4 +62,4 @@ See https://github.com/knative/community/issues/746 for the original discussion

* The TOC does not yet have a recommended process for handling issues which have reached "In Progress" but have some type of time-based delay (e.g. feature is released in "alpha", needs to be progressed to "beta" after one release). One option is to create a new "Ready To Work" issue like `Post-1.3: promote $FEATURE to Beta` and close the original issue, but this is up to Working Group leads to manage.

* TOC reviews will generally focus on management and possibly coordination implications of work items, and will generally rely on the judgement of the working group in terms of which items to complete first.
* TOC reviews will generally focus on management and possibly coordination implications of work items, and will generally rely on the judgement of the working group in terms of which items to complete first.
2 changes: 1 addition & 1 deletion mechanics/TOC.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ Current TOC members and
with at least 3 months tenure are eligible to stand for election. The approver
role may be held within either
[Knative](https://github.com/knative/community/blob/main/peribolos/knative.yaml) or
[Knative Sandbox](https://github.com/knative/community/blob/main/peribolos/knative-sandbox.yaml).
[Knative Sandbox](https://github.com/knative/community/blob/main/peribolos/knative-extension.yaml).
Candidates may self-nominate or be nominated by another eligible member. The
approximate time commitment of a TOC member is around 8 hours per week.

Expand Down
2 changes: 1 addition & 1 deletion peribolos/knative-sandbox-OWNERS_ALIASES
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# This file is auto-generated from peribolos.
# Do not modify this file, instead modify peribolos/knative-sandbox.yaml
# Do not modify this file, instead modify peribolos/knative-extension.yaml

aliases:
async-component-approvers:
Expand Down
4 changes: 2 additions & 2 deletions peribolos/knative-sandbox.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
orgs:
knative-sandbox:
knative-extension:
name: Knative Sandbox
description: Sandbox for projects that are part of the broader knative project
email: [email protected]
Expand Down Expand Up @@ -602,7 +602,7 @@ orgs:
members:
- travis-minke-sap
Function Runtime Writers:
description: Grants write access to knative-sandbox/func-go
description: Grants write access to knative-extension/func-go
privacy: closed
repos:
func-go: write
Expand Down