Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve spelling and wording #27

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 12 additions & 12 deletions cara-berkontribusi-opensources-github.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
## Latar belakang
cek [Pondokprogrammer](pondokprogrammer.com/tutorial-github/).

Mungkin sudah terlalu sering kita bekerja mandiri pada project pribadi. Disini, saya akan menunjukkan bagaimana caranya berkontribusi di project lain. Hal termudah untuk mencapai itu adalah dengan mencari proyek open source. Proyek perangkat lunak open source merupakan proyek yang memberikan kode program kepada penggunanya secara bebas, dan tak jarang pengembangannya dilakukan secara terbuka; siapapun boleh berkontribusi dalam menulis kode tersebut.
Mungkin sudah terlalu sering kita bekerja mandiri pada project pribadi. Di sini, saya akan menunjukkan bagaimana caranya berkontribusi di project lain. Hal termudah untuk mencapai itu adalah dengan mencari proyek open source. Proyek perangkat lunak open source merupakan proyek yang memberikan kode program kepada penggunanya secara bebas, dan tak jarang pengembangannya dilakukan secara terbuka; siapa pun boleh berkontribusi dalam menulis kode tersebut.

Menggunakan perangkat lunak open source tentunya sangat baik, karena selain tidak melakukan pembajakan, kita juga mendukung para pengembang dari perangkat lunak yang kita gunakan. Tetapi, akan lebih baik lagi jika kita juga ikut berkontribusi, mulai dari kontribusi pengunaan, pelaporan bug, sampai dengan kontribusi kode. Kontribusi pada proyek open source akan membantu kita untuk meningkatkan kemampuan pengembangan perangkat lunak."
Menggunakan perangkat lunak open source tentunya sangat baik, karena selain tidak melakukan pembajakan, kita juga mendukung para pengembang dari perangkat lunak yang kita gunakan. Tetapi, akan lebih baik lagi jika kita juga ikut berkontribusi, mulai dari kontribusi penggunaan, pelaporan bug, sampai dengan kontribusi kode. Kontribusi pada proyek open source akan membantu kita untuk meningkatkan kemampuan pengembangan perangkat lunak."

----
## Bagaimana
Expand All @@ -22,15 +22,15 @@ Berikut langkah-langkahnya secara singkat:
1. Cari proyek open source.
*Kali ini, saya sebagai pengembang Android akan menggunakan* **[Material Tabs](https://github.com/neokree/MaterialTabs)** *sebagai contoh.*
2. Cari info tentang aturan kontribusi, atau hubungi developer yang terkait baik via email atau media sosial.
3. Jika memang tidak tertera aturan kontribusi dan sang developer tidak merespon, anda bisa langsung melakukan fork proyek yang akan anda kontribusikan.
4. Setelah selesai fork, maka repository akan masuk ke daftar repo milik anda.
3. Jika memang tidak tertera aturan kontribusi dan sang developer tidak merespons, Anda bisa langsung melakukan fork proyek yang akan Anda kontribusikan.
4. Setelah selesai fork, maka repository akan masuk ke daftar repo milik Anda.

----
## Time to GO CODE ;)

NB: gunakan `git --help` untuk melihat perintah-perintah git lainnya.

1. Cloning project yang sudah anda fork ke akun anda
1. Cloning project yang sudah Anda fork ke akun Anda

git clone <alamat-repo>

Expand All @@ -54,9 +54,9 @@ NB: gunakan `git --help` untuk melihat perintah-perintah git lainnya.

git checkout -b sample-project

4. Di cabang baru ini lah kita akan untuk melakukan perubahan kode, yang nantinya bisa kita push ke repo pusat. Untuk berpindah branch bisa kita gunakan `git checkout <nama-cabang>`, dimana `<nama-cabang>` adalah nama yang anda gunakan pada langkah sebelumnya.
4. Di cabang baru ini lah kita akan untuk melakukan perubahan kode, yang nantinya bisa kita push ke repo pusat. Untuk berpindah branch bisa kita gunakan `git checkout <nama-cabang>`, di mana `<nama-cabang>` adalah nama yang Anda gunakan pada langkah sebelumnya.

5. Setelah melakukan perubahan, kita bisa lakukan commit berisi deskripsi singkat tentang perubahan yang anda lakukan. Tetapi jika ada penambahan file, bisa menggunakan perintah `git add <nama-file-baru>`, atau gunakan `git add .` untuk menambahkan semua perubahan yang ada di direktori tersebut secara rekursif. Setelah itu baru bisa kita commit.
5. Setelah melakukan perubahan, kita bisa lakukan commit berisi deskripsi singkat tentang perubahan yang Anda lakukan. Tetapi jika ada penambahan file, bisa menggunakan perintah `git add <nama-file-baru>`, atau gunakan `git add .` untuk menambahkan semua perubahan yang ada di direktori tersebut secara rekursif. Setelah itu baru bisa kita commit.

git commit -m "<pesan singkat>"

Expand All @@ -73,7 +73,7 @@ NB: gunakan `git --help` untuk melihat perintah-perintah git lainnya.
git fetch upstream
git merge upstream/master

8. Dengan proses diatas, setidaknya kita telah bisa memastikan bahwa tidak ada konflik dengan repo pusat. Sekarang kita kembali ke branch lokal development kita `sample-project`.
8. Dengan proses di atas, setidaknya kita telah bisa memastikan bahwa tidak ada konflik dengan repo pusat. Sekarang kita kembali ke branch lokal development kita `sample-project`.

git checkout sample-project

Expand All @@ -85,20 +85,20 @@ NB: gunakan `git --help` untuk melihat perintah-perintah git lainnya.

git push origin sample-project

11. Setelah di push, kita akan melakukan pull request dan membandingkan perubahan yang telah anda lakukan terhadap repo pusat. Anda juga bisa menyisipkan pesan untuk memberitahukan developer pemilik repo pusat tentang apa yang anda lakukan. Setelah yakin terhadap perubahan yang telah anda lakukan, silahkan pilih create pull request dan menunggu tanggapan dari pemilik repo pusat. Lebih lengkapnya bisa anda lihat di tag screenshot.
11. Setelah di-push, kita akan melakukan pull request dan membandingkan perubahan yang telah Anda lakukan terhadap repo pusat. Anda juga bisa menyisipkan pesan untuk memberitahukan developer pemilik repo pusat tentang apa yang Anda lakukan. Setelah yakin terhadap perubahan yang telah Anda lakukan, silakan pilih create pull request dan menunggu tanggapan dari pemilik repo pusat. Lebih lengkapnya bisa Anda lihat di tag screenshot.

----
## Screenshot

Ganti branch master ke branch yang anda buat (sample-project) dan pilih pull request / new pull request.
Ganti branch master ke branch yang Anda buat (sample-project) dan pilih pull request / new pull request.

![branch-sampleproject-creatorbe-screenshot](https://raw.githubusercontent.com/CreatorB/ss/master/git/jasaprogrammer-creatorbe-pondokprogrammer-pull.png)

Setelah itu anda akan masuk pada konfirmasi pull request, disini anda bisa membandingkan code antar branch dan menyisipkan komentar.
Setelah itu Anda akan masuk pada konfirmasi pull request, di sini Anda bisa membandingkan code antar branch dan menyisipkan komentar.

![branch-review-creatorbe-screenshot](https://raw.githubusercontent.com/CreatorB/ss/master/git/jasaprogrammer-creatorbe-pondokprogrammer-pull-message.png)

Setelah melakukan pull request maka akan menuju tampilan request yang telah anda lakukan terhadap project tersebut.
Setelah melakukan pull request maka akan menuju tampilan request yang telah Anda lakukan terhadap project tersebut.

![branch-preview-creatorbe-screenshot](https://raw.githubusercontent.com/CreatorB/ss/master/git/jasaprogrammer-creatorbe-pondokprogrammer-pull-review.png)

Expand Down
18 changes: 9 additions & 9 deletions git-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ Atau bisa dibilang *cara kerja menggunakan Git*

$ git clone myrepo

- Hacking / rubah code
- Hacking / ubah kode
- Commit

$ git commit -am "log message"
Expand All @@ -26,7 +26,7 @@ Atau bisa dibilang *cara kerja menggunakan Git*


### Outcome:
- Commit gak jelas juntrungannya
- Commit tidak jelas juntrungannya
- Tiap commit tidak bisa di-apply sebagai patch yang solid
- Merge commit di mana-mana

Expand All @@ -35,7 +35,7 @@ Atau bisa dibilang *cara kerja menggunakan Git*
## Git Zealot
### Ciri khas:
- Commit per task
- Bikin branch bahkan untuk ngerjain 1 commit doang
- Membuat branch bahkan untuk mengerjakan 1 commit saja
- Rebase melulu

### Cara kerja:
Expand All @@ -44,12 +44,12 @@ Atau bisa dibilang *cara kerja menggunakan Git*
$ git clone myrepo
$ git checkout -b topic-branch

- Hack / rubah code
- Pilih hunk yang mau distage
- Hack / ubah kode
- Pilih hunk yang mau di-stage

$ git add -i

- Commit terus Push ke branch baru yang telah dibuat
- Commit, lalu push ke branch baru yang telah dibuat

$ git commit -m "log message"
$ git push origin topic-branch
Expand All @@ -64,7 +64,7 @@ Atau bisa dibilang *cara kerja menggunakan Git*
$ git checkout topic-branch

- Pilih:
- `$ git rebase master` (awas intermediate commit juga harus ditest)
- `$ git rebase master` (awas, intermediate commit juga harus ditest)
- `$ git checkout master` dan `$ git merge topic-branch` (jadi ada merge commit) (preferred seperti katanya [nvie](http://nvie.com/posts/a-successful-git-branching-model/))
- Resolve conflicts
- Commit
Expand All @@ -75,10 +75,10 @@ Atau bisa dibilang *cara kerja menggunakan Git*

$ git format-patch

- send untuk review/pull request
- Send untuk review/pull request

### Outcome:
- Clean, linear history
- Patch bisa di-apply secara clean
- Tiap commit jelas urusannya
- Butuh waktu lama untuk pilih2 hunk
- Butuh waktu lama untuk pilih-pilih hunk
2 changes: 1 addition & 1 deletion instalasi-git-gnu-linux.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Instalasi Git di GNU/Linux
Meski di berberapa distro GNU/Linux telah di sediakan git secara bawaan,akan tetapi tidak semua distro membawa git secara bawaan di dalam distronya
Meski di berberapa distro GNU/Linux telah disediakan git secara bawaan, akan tetapi tidak semua distro membawa git secara bawaan di dalam distronya
## Arch Linux
```
pacman -S git
Expand Down
30 changes: 15 additions & 15 deletions menggunakan-git.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@
git checkout master
```

10. Update dulu repo lokal, kali aja ada yang sudah commit sementara kita sibuk
10. Update repo lokal terlebih dahulu, mungkin saja ada yang sudah commit sementara kita sibuk
```
git svn rebase
git fetch origin + git merge origin/master
Expand All @@ -115,28 +115,28 @@
```
git merge --no-ff --no-commit branch_kerja
```
`no-ff`: semua commit gabung jadi satu, dicommit lagi di branch tujuan
`no-commit`: jangan langsung commit, biarin aja di staging index, supaya kita bisa bikin commit msg sendiri biasanya berisi release note
`no-ff`: semua commit gabung jadi satu, di-commit lagi di branch tujuan
`no-commit`: jangan langsung commit, biarkan saja di staging index, supaya kita bisa membuat commit message sendiri biasanya berisi release note
`squash`: semua commit digabung jadi 1

kadang-kadang kena fast forward kalau di master tidak ada commit, sehingga historinya menjadi linier
Kadang-kadang terjadi fast forward kalau di master tidak ada commit, sehingga historinya menjadi linier
Kalau master tidak ada commitnya, gunakan opsi `--no-ff` untuk menandai commit
```
git merge --squash --no-ff branch_kerja
```

Fast forward adalah memindahkan pointer HEAD branch target menjadi sama seperti branch asal.
Fast forward adalah pemindahan pointer HEAD branch target menjadi sama seperti branch asal.
Merge fast forward tidak menimbulkan commit baru

12. Cek dulu apakah ada konflik.
Kalau ada, fix dulu, baru commit.
12. Cek apakah ada konflik.
Kalau ada, fix terlebih dahulu, baru commit.
Kalau tidak ada, ya langsung saja commit
```
git add .
git commit -m "implement task #12"
```

13. Sudah ok semua, commit ke svn repo
13. Sudah oke semua, commit ke svn repo
```
git svn dcommit
```
Expand All @@ -147,7 +147,7 @@
```
git reset --hard HEAD
```
- Skenario 2: sudah add tapi belum commit, add nya mau dicancel
- Skenario 2: sudah add tapi belum commit, add-nya mau di-cancel
```
git reset -- namafile
```
Expand Down Expand Up @@ -177,7 +177,7 @@
```

15. Interrupted workflow
Misalnya, lagi asik tambah fitur, ada request bugfix
Misalnya, sedang asyik tambah fitur, ada request bugfix

- pindahkan work in progress ke branch baru
```
Expand Down Expand Up @@ -233,13 +233,13 @@ Skema URL:
git fetch namaremote
```

untuk meremove juga branch yang sudah gak ada di remote, gunakan
untuk menghapus juga branch yang sudah tidak ada di remote, gunakan
opsi `--prune`
```
git fetch --prune namaremote
```

4. Setelah difetch, merge ke local supaya bisa diedit
4. Setelah di-fetch, merge ke local supaya bisa diedit
```
git merge
```
Expand All @@ -256,7 +256,7 @@ Otomatis checkout
git checkout -b localbranch namaremote/remotebranch
```

Kalo namanya sama (localbranch = remotebranch), bisa pakai `--track`
Kalau namanya sama (localbranch = remotebranch), bisa pakai `--track`
```
git checkout --track namaremote/remotebranch
```
Expand All @@ -266,12 +266,12 @@ Kalo namanya sama (localbranch = remotebranch), bisa pakai `--track`
git push namaremote localbranch:remotebranch
```

kalau nama branch di remote sama dengan local
Kalau nama branch di remote sama dengan local
```
git push namaremote namabranch
```

kalau dikosongkan, git akan push ke remote branch yang namanya sama dengan local
Kalau dikosongkan, git akan push ke remote branch yang namanya sama dengan local
misalnya master &rarr; namaremote/master
```
git push namaremote
Expand Down
4 changes: 2 additions & 2 deletions migrasi-svn-git.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
svnadmin dump /path/ke/repo/svn > nama-file-dump
```

2. Copy ke pc kita sendiri supaya cepat prosesnya
2. Copy ke PC kita sendiri supaya cepat prosesnya

3. Restore lagi
```bash
Expand Down Expand Up @@ -60,7 +60,7 @@
git clone --bare git-svn-migrasi-project nama-project.git
```

12. Copy ke server untuk disharing menggunakan Gitosis
12. Copy ke server untuk di-share menggunakan Gitosis



Expand Down
2 changes: 1 addition & 1 deletion workflow-basic.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
$ git clone
$ git branch -a
$ git checkout -b topic-branch
$ // Hacking / rubah code
$ // Hacking / ubah kode
$ git add .
$ git commit -m "commit log"
$ git checkout master
Expand Down