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