This is an automated email from the ASF dual-hosted git repository.
wangxin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-dubbo.wiki.git
The following commit(s) were added to refs/heads/master by this push:
new a2d5951 init new committer guide
a2d5951 is described below
commit a2d595194389566490c1608524b83e7ce7144d95
Author: Xin Wang <xin.victorw...@gmail.com>
AuthorDate: Fri Jun 1 00:16:30 2018 +0800
init new committer guide
---
New-Committer-Guide.md | 90 ++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 90 insertions(+)
diff --git a/New-Committer-Guide.md b/New-Committer-Guide.md
new file mode 100644
index 0000000..c3007f8
--- /dev/null
+++ b/New-Committer-Guide.md
@@ -0,0 +1,90 @@
+# Apache committer guide
+
+## First: How to become a committer
+
+### Initializes the initiator of the project hatching
+At the project incubator stage, there will be an initialize committers list in
the proposal of the incubator project. Confirm that you are one of the
initialize committers. After the vote is passed in the Apache incubator
community, the committer can start preparing his account. You can see
[incubator wiki](https://wiki.apache.org/incubator/).
+
+### The active contributor is elected as a committer
+In the late development process, a active contributor can be elected as a
committer. See [how to become a
committer](https://www.apache.org/dev/new-committers-guide.html#becoming-a-committer)
+
+## Second: The individual contributor submits ICLA
+
+### 1, Apache ID
+Choose a Apache ID not in the [apache committers list
page](http://people.apache.org/committer-index.html).
+
+### 2, Individual Contributor License Agreement (ICLA):
+Download the [ICLA template](https://www.apache.org/licenses/icla.pdf) to find
the available ID. After filling the icla.pdf personal information correctly,
printing, signing, scanning, and sending mail as an attachment to the secretary
secret...@apache.org, the secretary will help to create the Apache user ID. At
the same time, a your...@apache.org mailbox can be created. You can see if the
user has been created on the [apache committers list page
(http://people.apache.org/committer-inde [...]
+
+## Third: Join the Apache developer group
+
+* 1, login the [Apache account tool](https://id.apache.org/), when you login
at the first time, you can select the "Change password?" checkbox to get the
initializer password. Then the initializer password will be sent to the forward
mailbox (the developer mail recorded in the project incubator proposal)
+
+* 2, about Apache mailbox: apache.org mailbox does not have its own mail
content storage server. It needs to borrow other mail providers' mail content
storage and mail sending functions. In many voting sessions, Apache mailbox is
recommended.
+
+There is a question about how to configure the apache.org mailbox forwarding
function in other mailboxes.
+
+1) inbox: to receive mails that sent to youer...@apache.org mailbox. The
forward mailbox in the first step the configured int the Apache account tool
can use forward mailbox to pick up the mail.
+
+2) the Outbox: the sent email will shows the sender as your...@apache.org
account. Please refer to: [set up Apache mailbox
guide](https://reference.apache.org/committer/email) and [gmail mailbox
setting]http://gmailblog.blogspot.com/2009/07/send-mail-from-another-address-without.html.
In other mailbox service settings, this forwarding mode is not easy to find.
Gmail is the most convenient, so it is recommended to use Gmail (not
advertising).
+
+* 3, Modify the homepage URL option in the edit page, homepage link of your
account can be added in [apache committer index
page](http://people.apache.org/committer-index.html)
+
+* 4, Modify the GitHub account in the edit page, and an email will be sent to
invite you to join the github.com/apache-commiiters group. Now, please learn
from the way [ASF
works](http://www.apache.org/foundation/how-it-works.html#developers) to do
some basic preparation of ASF development.
+
+## Fourth: To obtain write permission of the project
+
+The operation of the [GitBox account link
tool](https://gitbox.apache.org/setup/)
+
+### 1, Apache account authorization
+
+According to the prompt, the OAuth protocol of Apache account is authorized to
login.
+
+### 2, Github account authorization
+
+According to the prompt, the OAuth protocol of Github account is authorized to
login.
+
+### 3, Set up GitHub account in github.com, two-factors authorization (2FA)
+
+According to [authorized GitHub 2FA
wiki](https://help.github.com/articles/configuring-two-factor-authentication-via-a-totp-mobile-app/)
operation:
+
+* 1) install Google identity checker on mobile phone app
+* 2), Following the [authorized GitHub 2FA
wiki](https://help.github.com/articles/configuring-two-factor-authentication-via-a-totp-mobile-app/),
you can operation step by step .
+
+In the [two-factors authorization authentication (2. Scan this barcode with
your app.)](https://github.com/settings/two_factor_authentication/verify) page,
it is not recommended to select a two-dimensional code with a mobile phone,
because some of the mobile phones will not be able to scan it.
+
+Please open the cell phone "Google Authenticator" app, click "+" to select
"input the secret key": write the GitHub account in the account name input box.
In your "secret key" input box, write the text of the "enter this text code"
link in the open web page. After clicking "add" in app, 6 digit dynamic will be
generated for this account. Write the 6 digit number to the text box in the web
page, and then click "Enable". In this way, the 2fa is set to be successful.
+
+* 3), logout and login to Github again, and one more step will appear after
entering user name and password. Fill in the dynamic password and use the
dynamic password of app
+
+* 4), IIt will take about half an hour, and you will be notified by mail that
you have joined the XX project-committers developer group. You can also check
it in the [apache teams] (https://github.com/orgs/apache/teams) page yourself.
+
+* 5), After the 2fa has been submitted, you will have the permission check
problem for the cloned projects. The solution is selected below two.:
+
+* A. Apply for Access Token
+
+When access token is generated on GitHub, the token where the instruction line
needs a password is pasted.
+
+Reference website [referenced link
one](https://help.github.com/articles/https-cloning-errors/#provide-access-token-if-2fa-enabled)
and [referenced link
two](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/)
+
+* B. switch to SSH
+
+ssh-keygen then paste the content in the pub file into GitHub.
+
+* Note: ensure that GitHub's 2fa is "enable". When you set 2fa to "off", it
will be delisted by the corresponding Apache committer write permission group
until you set it up again.
+
+## Fifth: other
+
+### The Apache way
+
+See [wiki](http://apache.org/foundation/governance/).
+
+The community is more important than the code
+If not discussed in the community (mailing list), just as it did not happen
+
+### A small benefit
+
+Jetbrains company gives Apache committers a small benefit that is free to use
idea's full series products. The specific address is:
https://www.jetbrains.com/shop/eform/apache? Product=ALL
+
+### Reference wiki
+https://www.apache.org/dev/new-committers-guide.html
\ No newline at end of file
--
To stop receiving notification emails like this one, please contact
wang...@apache.org.
