[calcite] branch master updated: Site: Add instructions for managing Calcite repos through GitHub

[za...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

zabetak pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/calcite.git


The following commit(s) were added to refs/heads/master by this push:
     new 3e7349f  Site: Add instructions for managing Calcite repos through GitHub
3e7349f is described below

commit 3e7349f78d3edf6e6c7f2ca93aebed94f0f6aeb1
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