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-site.git
The following commit(s) were added to refs/heads/master by this push:
new 2bb32ed Site: Add instructions for managing Calcite repos through
GitHub
2bb32ed is described below
commit 2bb32ede16e3e2a98da2aaed89929167ab224cf3
Author: Stamatis Zampetakis <zabe...@gmail.com>
AuthorDate: Wed Jul 1 00:57:24 2020 +0200
Site: Add instructions for managing Calcite repos through GitHub
---
docs/howto.html | 29 +++++++++++++++++++++++++++++
1 file changed, 29 insertions(+)
diff --git a/docs/howto.html b/docs/howto.html
index b55d007..ac8e78f 100644
--- a/docs/howto.html
+++ b/docs/howto.html
@@ -118,6 +118,7 @@ adapters.</p>
</ul>
</li>
<li><a href="#advanced-topics-for-committers"
id="markdown-toc-advanced-topics-for-committers">Advanced topics for
committers</a> <ul>
+ <li><a
href="#managing-calcite-repositories-through-github-for-calcite-committers"
id="markdown-toc-managing-calcite-repositories-through-github-for-calcite-committers">Managing
Calcite repositories through GitHub (for Calcite committers)</a></li>
<li><a href="#merging-pull-requests-for-calcite-committers"
id="markdown-toc-merging-pull-requests-for-calcite-committers">Merging pull
requests (for Calcite committers)</a></li>
<li><a href="#set-up-pgp-signing-keys-for-calcite-committers"
id="markdown-toc-set-up-pgp-signing-keys-for-calcite-committers">Set up PGP
signing keys (for Calcite committers)</a></li>
<li><a
href="#set-up-nexus-repository-credentials-for-calcite-committers"
id="markdown-toc-set-up-nexus-repository-credentials-for-calcite-committers">Set
up Nexus repository credentials (for Calcite committers)</a></li>
@@ -575,6 +576,34 @@ need to be re-generated only every build, only when the
schema changes.</p>
<p>The following sections are of interest to Calcite committers and in
particular release managers.</p>
+<h2
id="managing-calcite-repositories-through-github-for-calcite-committers">Managing
Calcite repositories through GitHub (for Calcite committers)</h2>
+
+<p>Committers have write access to Calcite’s
+<a href="https://gitbox.apache.org/repos/asf#calcite";>ASF git repositories</a>
hosting
+the source code of the project as well as the website.</p>
+
+<p>All repositories present on GitBox are available on GitHub with
write-access
+enabled, including rights to open/close/merge pull requests and address
issues.</p>
+
+<p>In order to exploit the GitHub services, committers should link their ASF
and
+GitHub accounts via the <a href="https://gitbox.apache.org/setup/";>account
linking page</a>.</p>
+
+<p>Here are the steps:</p>
+
+<ul>
+ <li>Set your GitHub username into your <a
href="https://id.apache.org/";>Apache profile</a>.</li>
+ <li>Enable <a
href="https://help.github.com/articles/securing-your-account-with-two-factor-authentication-2fa/";>GitHub
2FA</a>
+on your GitHub account.</li>
+ <li>Activating GitHub 2FA changes the authentication process and may affect
the way you
+ <a
href="https://help.github.com/en/github/authenticating-to-github/accessing-github-using-two-factor-authentication#using-two-factor-authentication-with-the-command-line";>access
GitHub</a>.
+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).</li>
+ <li>Merge your Apache and GitHub accounts using the <a
href="https://gitbox.apache.org/setup/";>account linking page</a>
+(you should see 3 green checks in GitBox).</li>
+ <li>Wait at least 30 minutes for an email inviting you to Apache GitHub
Organization.</li>
+ <li>Accept the invitation and verify that you are a <a
href="https://github.com/orgs/apache/teams/calcite-committers/members";>member
of the team</a>.</li>
+</ul>
+
<h2 id="merging-pull-requests-for-calcite-committers">Merging pull requests
(for Calcite committers)</h2>
<p>These are instructions for a Calcite committer who has reviewed a pull
request
