Add repository renaming process to request guidelines#57
Conversation
Updated the document to include repository renaming process and its implications.
There was a problem hiding this comment.
Pull request overview
Updates the repository request guidelines to explicitly cover repository renames and highlight operational implications (URL changes and downstream updates) within the ECMWF GitHub Enterprise process.
Changes:
- Expands the scope of the guidelines to include repository renaming alongside creation and transfers.
- Adds a dedicated “Requesting a Repository Rename” subsection with required details and an impact warning.
- Updates the workflow section to reflect rename handling by User Services.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| @@ -1,16 +1,16 @@ | |||
| # Requesting a New GitHub Repository | |||
| # Requesting a New or Renaming existing GitHub Repository | |||
There was a problem hiding this comment.
The H1 heading reads awkwardly and includes a trailing space. Consider rephrasing to something like “Requesting a New or Renaming an Existing GitHub Repository” (and remove the trailing whitespace) for correct grammar/capitalization.
| # Requesting a New or Renaming existing GitHub Repository | |
| # Requesting a New or Renaming an Existing GitHub Repository |
| GitHub has strict rules regarding repository ownership and creation. | ||
|
|
||
| Because all repositories within the ECMWF GitHub Enterprise are owned by ECMWF, individual users are **not permitted** to directly create repositories within those ECMWF Github organisations. | ||
| Because all repositories within the ECMWF GitHub Enterprise are owned by ECMWF, individual users are **not permitted** to directly create or rename repositories within those ECMWF Github organisations. |
There was a problem hiding this comment.
Use the correct GitHub capitalization (“GitHub”, not “Github”) and remove the double space in “those ECMWF …” to keep wording consistent and avoid typos in the docs.
| Because all repositories within the ECMWF GitHub Enterprise are owned by ECMWF, individual users are **not permitted** to directly create or rename repositories within those ECMWF Github organisations. | ||
|
|
||
| Instead, all repository creations and transfers must go through a centralized request process to ensure compliance and management of the single namespace. This ensures ECMWF can properly manage naming conventions, visibility, access policies, compliance requirements, billing, and security settings for all assets under Github Enterprise. | ||
| Instead, all repository creations, transfers, and renames must go through a centralized request process to ensure compliance and management of the single namespace. This ensures ECMWF can properly manage naming conventions, visibility, access policies, compliance requirements, billing, and security settings for all assets under Github Enterprise. |
There was a problem hiding this comment.
This paragraph also uses “Github Enterprise”; please capitalize it as “GitHub Enterprise” for consistency with GitHub branding used elsewhere in the document.
| Instead, all repository creations, transfers, and renames must go through a centralized request process to ensure compliance and management of the single namespace. This ensures ECMWF can properly manage naming conventions, visibility, access policies, compliance requirements, billing, and security settings for all assets under Github Enterprise. | |
| Instead, all repository creations, transfers, and renames must go through a centralized request process to ensure compliance and management of the single namespace. This ensures ECMWF can properly manage naming conventions, visibility, access policies, compliance requirements, billing, and security settings for all assets under GitHub Enterprise. |
| ## 2. How to Request a Repository | ||
|
|
||
| Whether you need to create a repository from scratch, transfer an existing repository from another GitHub owner, or migrate a repository from Bitbucket, you must submit a formal request. | ||
| Whether you need to create a repository from scratch, transfer an existing repository from another GitHub owner, migrate a repository from Bitbucket, or **rename an existing repository** you must submit a formal request. |
There was a problem hiding this comment.
Missing comma after “rename an existing repository” makes the sentence hard to parse. Add a comma before “you must submit a formal request.”
| Whether you need to create a repository from scratch, transfer an existing repository from another GitHub owner, migrate a repository from Bitbucket, or **rename an existing repository** you must submit a formal request. | |
| Whether you need to create a repository from scratch, transfer an existing repository from another GitHub owner, migrate a repository from Bitbucket, or **rename an existing repository**, you must submit a formal request. |
|
|
||
| 1. **Review & Approval:** The Head of Development will review your request to ensure it aligns with ECMWF's software strategy and naming conventions. Your repository name will be checked for clarity and relevance to its intended purpose. You may be contacted for additional information or clarification during this stage, including a discussion on the name and scope of the repository. | ||
| 2. **Creation & Configuration:** If approved, **User Services** will manually create or transfer the repository and apply the requested access permissions. You maybe contacted to clarify some technical details of the repository setup, or as part of the transfer process if applicable. | ||
| 2. **Creation, Rename & Configuration:** If approved, **User Services** will manually create, rename or transfer the repository and apply the requested access permissions. You maybe contacted to clarify some technical details of the repository setup, or as part of the transfer process if applicable. |
There was a problem hiding this comment.
Grammar: “You maybe contacted” should be “You may be contacted”. Also consider adding a comma in “create, rename, or transfer” for readability.
| 2. **Creation, Rename & Configuration:** If approved, **User Services** will manually create, rename or transfer the repository and apply the requested access permissions. You maybe contacted to clarify some technical details of the repository setup, or as part of the transfer process if applicable. | |
| 2. **Creation, Rename & Configuration:** If approved, **User Services** will manually create, rename, or transfer the repository and apply the requested access permissions. You may be contacted to clarify some technical details of the repository setup, or as part of the transfer process if applicable. |
…ouble space, and missing punctuation
Updated the document to include repository renaming process and its implications.
Description
Contributor Declaration
By opening this pull request, I affirm the following: