You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@calcite.apache.org by za...@apache.org on 2020/06/30 22:57:06 UTC
[calcite] 03/03: Site: Add instructions for managing Calcite repos
through GitHub
This is an automated email from the ASF dual-hosted git repository.
zabetak pushed a commit to branch site
in repository https://gitbox.apache.org/repos/asf/calcite.git
commit a171fe4b3d0f374877f6ac028056d405520b1bff
Author: Stamatis Zampetakis <za...@gmail.com>
AuthorDate: Fri Jun 5 12:36:42 2020 +0200
Site: Add instructions for managing Calcite repos through GitHub
Close apache/calcite#2009
---
site/_docs/howto.md | 26 ++++++++++++++++++++++++++
1 file changed, 26 insertions(+)
diff --git a/site/_docs/howto.md b/site/_docs/howto.md
index d14c0e0..d87a33d 100644
--- a/site/_docs/howto.md
+++ b/site/_docs/howto.md
@@ -474,6 +474,32 @@ $ ./src/main/scripts/generate-protobuf.sh
The following sections are of interest to Calcite committers and in
particular release managers.
+## Managing Calcite repositories through GitHub (for Calcite committers)
+
+Committers have write access to Calcite's
+[ASF git repositories](https://gitbox.apache.org/repos/asf#calcite) hosting
+the source code of the project as well as the website.
+
+All repositories present on GitBox are available on GitHub with write-access
+enabled, including rights to open/close/merge pull requests and address issues.
+
+In order to exploit the GitHub services, committers should link their ASF and
+GitHub accounts via the [account linking page](https://gitbox.apache.org/setup/).
+
+Here are the steps:
+
+ * Set your GitHub username into your [Apache profile](https://id.apache.org/).
+ * Enable [GitHub 2FA](https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/)
+on your GitHub account.
+ * Activating GitHub 2FA changes the authentication process and may affect the way you
+ [access GitHub](https://help.github.com/en/github/authenticating-to-github/accessing-github-using-two-factor-authentication#using-two-factor-authentication-with-the-command-line).
+You may need to establish personal access tokens or upload your public SSH key to GitHub depending on the
+protocol that you are using (HTTPS vs. SSH).
+ * Merge your Apache and GitHub accounts using the [account linking page](https://gitbox.apache.org/setup/)
+(you should see 3 green checks in GitBox).
+ * Wait at least 30 minutes for an email inviting you to Apache GitHub Organization.
+ * Accept the invitation and verify that you are a [member of the team](https://github.com/orgs/apache/teams/calcite-committers/members).
+
## Merging pull requests (for Calcite committers)
These are instructions for a Calcite committer who has reviewed a pull request