Contents
1. Sign the CLA
2. Fork the kubernetes/website repository
3. Clone fork repository to local
4. Tạo branch mới để bắt đầu việc dịch tài liệu
5. Commit and Push
6. Create a Pull Request
1. Sign the CLA
Để có thể contribute vào dự án Kubernetes thì trước tiên bạn phải sign The Contributor License Agreement
1.1. Log in to the Linux Foundation ID Portal with Github
- Nếu bạn là contributor độc lập, click vào link: https://identity.linuxfoundation.org/?destination=node/285/individual-signup
- Nếu bạn đóng góp dưới danh nghĩa cty, click vào link: https://identity.linuxfoundation.org/?destination=node/285/employee-signup
1.2. Create Linux Foundation ID Portal account with correct e-mail address
1.3. Complete signing process
Sau khi tạo xong tài khoản, làm theo các hướng dẫn để hoàn tất việc signing qua HelloSign.
1.4. Look for an email indicating successful signup
The Linux Foundation
Hello,
You have signed CNCF Individual Contributor License Agreement. You can see your document anytime by clicking View on HelloSign.
2. Fork the kubernetes/website repository
- Đi đến https://github.com/kubernetes/website
- Click vào nút
Fork
để fork repo kubernetes/website về github của bạn.
3. Clone the forked repository to local
Clone repo đã được forked ở bước trên về máy của bạn.
$ git clone https://github.com/$user/website.git
$ cd website
$ git remote add upstream https://github.com/kubernetes/website.git
# Never push to upstream master
$ git remote set-url --push upstream no_push
# Confirm that your remotes make sense:
$ git remote -v
$user
là account github của bạn.
4. Tạo branch mới để bắt đầu việc dịch tài liệu
Update local working directory:
$ cd website
$ git fetch upstream
$ git checkout master
$ git rebase upstream/master
Please don’t use git pull
instead of git fetch / rebase
. git pull
does a merge, which leaves merge commits. These make the commit history messy and violate the principle commits.
Tạo branch mới: mybranch
là tên bất kì, tùy thuộc vào PR bạn tạo.
$ git checkout -b mybranch
5. Commit and Push
Commit
Việc dịch tài liệu này chúng ta sẽ tập trung vào việc thêm các file vào thư mục nội dung Tiếng Việt: https://github.com/kubernetes/website/tree/master/content/vi
Các bạn ra ngoài thư mục content Tiếng Anh
: https://github.com/kubernetes/website/tree/master/content/en và chọn nội dung mà các bạn thấy hứng thú dịch rồi add file đã dịch xong vào thư mục tương ứng của nội dung Tiếng Việt
$ cd website/content/vi
$ git add <file-dịch>
Commit your changes:
$ git commit
Enter your commit message to describe the changes. See the tips for a good commit message at here.
Likely you go back and edit/build/test some more then git commit --amend
Push
Push your branch mybranch
to your forked repo on github.com.
$ git push -f $remotename mybranch
6. Create a Pull Request
- Go to your fork at https://github.com/$user/website
- Hit the button next to branch
mybranch
- Flow the following processes to create a new pull request