Nafies Luthfi
8 years ago
2 changed files with 124 additions and 43 deletions
@ -0,0 +1,85 @@ |
|||
# Kontribusi ke Free PMO |
|||
|
|||
Terima kasih karena telah berkenan mempertimbangkan untuk berkontribusi pada project ini. Mari kita buat software Free PMO menjadi jauh lebih baik. |
|||
|
|||
### Submit Issue |
|||
Project ini masih terus dikembangkan. Sebagian besar fitur yang telah dibuat memiliki **Feature** atau **Unit Testing**, namun sangat mungkin masih ada **bug** yang terlewat dari pengujian tersebut. Jika selama menggunakan software ini Anda temukan **bug** atau **error**, silakan [melaporkan **Issue**](https://github.com/nafiesl/free-pmo/issues/new) dengan **prefix Subject : [BUG]**. |
|||
|
|||
Kita akan mencoba minimalisir **bug** sebisa mungkin. |
|||
|
|||
> Sebelum submit sebuah issue, ada baiknya Anda mencari pada daftar issue sudah dilaporkan oleh kontributor lain, siapa tahu sudah ada yang melaporkan :) |
|||
|
|||
### Usulan Fitur Baru |
|||
Pada dasarnya Free PMO sudah mencakup fitur-fitur dasar dalam pengelolaan project (terutama dari sudut pandang *freelancer*). Sangat mungkin beberapa fitur ditambahkan pada masa akan datang. Jika Anda memiliki **ide** yang ingin diusulkan dan dituangkan menjadi sebuah fitur pada project ini agar semua dapat menikmatinya, silakan usulkan dengan **submit Issue** dengan **prefix Subject : [PROPOSAL]**. |
|||
|
|||
Dengan senang hati kita akan diskusikan. |
|||
|
|||
### Membuat Pull Request |
|||
|
|||
Wah, bagian ini adalah kontribusi yang luar biasa, Anda sudah berkenan meluangkan waktu dan pikiran untuk membantu banyak orang, terima kasih banyak. Ada beberapa **kategori pull request** yang dapat Anda berikan : |
|||
|
|||
#### 1. Bugfix |
|||
|
|||
Di mana Anda membantu dalam **perbaikan error** yang dilaporkan oleh kontributor lain melalui [**Issue**](https://github.com/nafiesl/free-pmo/issues). Jika perbaikan error ini berkaitan dengan interaksi ke database (CRUD Operation), mohon agar Anda : |
|||
|
|||
1. Membuat **testing**, terkait fitur yang memiliki bug. |
|||
2. Pastikan **semua testing passed** pada saat Anda melakukan **pull request**. |
|||
|
|||
Kita akan review sama-sama terhadap perubahan yang Anda lakukan. Sekedar memastikan tidak ada konflik yang terjadi saat **pull request** ini disetujui. |
|||
|
|||
#### 2. Kesalahan Penulisan |
|||
|
|||
Pada project ini sangat mungkin terjadi kesalahan penulisan pada `halaman web` software, bagian `komentar`, `dokumentasi`, maupun pada file `lang` yang banyak kita gunakan pada sistem. Jika Anda menemukan kesalahan itu, silakan lakukan **pull request** untuk kita perbaiki sama-sama. |
|||
|
|||
#### 3. New Feature |
|||
|
|||
Jenis **pull request** ini akan menambahkan fitur baru pada Free PMO. Jika Anda ingin melakukan pull request jenis ini, kami harapkan agar memenuhi ketentuan berikut : |
|||
|
|||
1. Fitur baru sudah diusulkan dan dibahas sebelumnya pada [**Issue**](https://github.com/nafiesl/free-pmo/issues). |
|||
2. Fitur tambahan dilengkapi dengan Feature Test atau Unit Test sesuai keperluan (terutama jika ada interaksi perubahan pada database). |
|||
3. Semua **testing passed**. |
|||
|
|||
Kita akan **review dan uji** fitur baru tersebut sebelum **pull request** disetujui. |
|||
|
|||
> **Catatan** |
|||
> |
|||
> Jika pada fitur baru terdapat **perubahan struktur** pada tabel yang sudah ada, silakan **langsung ubah pada file migration** yang bersangkutan, karena aplikasi Free PMO masih dalam tahap pengembangan. **Misal**: fitur baru memerlukan perubahan struktur tabel `payments`, silakan update file `2016_11_15_151228_create_payments_table.php`. |
|||
> |
|||
> Kemudian **mohon** diinformasikan **script sql** dari perubahan struktur tabel tersebut melalui **Komentar Commit** yang bersangkutan (seperti [contoh ini](https://github.com/nafiesl/free-pmo/commit/a813524f680e9926d64f1006a1c615acf86c24f1#commitcomment-26166267)). Hal ini dilakukan untuk mempermudah pengguna Free PMO existing jika ingin meng-update aplikasinya. |
|||
|
|||
|
|||
#### 4. Lang File |
|||
|
|||
Jenis **pull request** ini akan menambahkan **lang** file pada direktori `resources/lang` sesuai dengan konfigurasi `locale`-nya (misal `lang/en` untuk Bahasa Inggris). Saat ini file-file `lang` yang lengkap hanya pada direktori `id` untuk Bahasa Indonesia dan `en` (Bahasa Inggris). |
|||
|
|||
Jika Anda ingin menambahkan bahasa lainnya, silakan melakukan **pull request** untuk kita **review** bersama. |
|||
|
|||
### Kontribusi Donasi |
|||
|
|||
Sekedar mengingatkan, Free PMO adalah software management project yang bebas (merdeka) dan gratis di bawah [lisensi MIT](LICENSE). **Pengembang sudah ridho** jika Anda menggunakan dan memodifikasinya untuk tujuan pribadi maupun komersil selama Anda tidak menghapus file [lisensi](LICENSE) dari project ini. |
|||
|
|||
Tetapi jika ada merasa sangat terbantu dengan software ini, dan berniat untuk mendonasikan sebagai rezeki Anda kepada pengembang, silakan mengirimkan donasi melalui jalur berikut : |
|||
|
|||
|
|||
#### Rekening Transfer |
|||
|
|||
| No. Rekening | BCA // 7820088543 | |
|||
| --- | --- | |
|||
| Atas nama | **Nafies Luthfi** | |
|||
| Kode Transfer | 014 | |
|||
|
|||
#### atau |
|||
|
|||
[](https://www.paypal.me/nafiesl/) |
|||
|
|||
Terima kasih banyak saya ucapan. |
|||
|
|||
### Penutup |
|||
|
|||
Terima kasih atas kontribusinya, semoga menjadi kebaikan untuk semua. |
|||
|
|||
Salam hangat, |
|||
|
|||
<br> |
|||
Nafies Luthfi, |
|||
Pengembang Free PMO |
|||
@ -1,85 +1,81 @@ |
|||
# Kontribusi ke Free PMO |
|||
# Contributing to Free PMO |
|||
|
|||
Terima kasih karena telah berkenan mempertimbangkan untuk berkontribusi pada project ini. Mari kita buat software Free PMO menjadi jauh lebih baik. |
|||
Thanks for considering to contribute to this project. Let's make it better. |
|||
|
|||
> [Baca versi Bahasa Indonesia](CONTRIBUTING.id.md) |
|||
|
|||
### Submit Issue |
|||
Project ini masih terus dikembangkan. Sebagian besar fitur yang telah dibuat memiliki **Feature** atau **Unit Testing**, namun sangat mungkin masih ada **bug** yang terlewat dari pengujian tersebut. Jika selama menggunakan software ini Anda temukan **bug** atau **error**, silakan [melaporkan **Issue**](https://github.com/nafiesl/free-pmo/issues/new) dengan **prefix Subject : [BUG]**. |
|||
This project is still being developed. Most of the features have **Feature** or **Unit Testing**, but it is very likely that there are **bugs** that have missed the tests. If you find **bug** or **error** when you use this application, please [report Issue](https://github.com/nafiesl/free-pmo/issues/new) with subject **prefix: [BUG]**. |
|||
|
|||
Kita akan mencoba minimalisir **bug** sebisa mungkin. |
|||
We try to minimize **errors** and **bugs** as much as possible. |
|||
|
|||
> Sebelum submit sebuah issue, ada baiknya Anda mencari pada daftar issue sudah dilaporkan oleh kontributor lain, siapa tahu sudah ada yang melaporkan :) |
|||
> Before submitting an issue, you should look at the list of issues already reported by other contributors, your issue have been reported. :) |
|||
|
|||
### Usulan Fitur Baru |
|||
Pada dasarnya Free PMO sudah mencakup fitur-fitur dasar dalam pengelolaan project (terutama dari sudut pandang *freelancer*). Sangat mungkin beberapa fitur ditambahkan pada masa akan datang. Jika Anda memiliki **ide** yang ingin diusulkan dan dituangkan menjadi sebuah fitur pada project ini agar semua dapat menikmatinya, silakan usulkan dengan **submit Issue** dengan **prefix Subject : [PROPOSAL]**. |
|||
### New Feature Proposal |
|||
Basically Free PMO already includes basic features in project management (especially from a **freelancer** perspective). Very likely some features are added in the future. If you have an **idea** that you want proposed as a feature on this project, please suggest it by submit issue with **subject prefix: [PROPOSAL]**. |
|||
|
|||
Dengan senang hati kita akan diskusikan. |
|||
We will be happy to discuss it. |
|||
|
|||
### Membuat Pull Request |
|||
### Create new Pull Request |
|||
|
|||
Wah, bagian ini adalah kontribusi yang luar biasa, Anda sudah berkenan meluangkan waktu dan pikiran untuk membantu banyak orang, terima kasih banyak. Ada beberapa **kategori pull request** yang dapat Anda berikan : |
|||
Wow, this part is a remarkable contribution, you have spent time and thoughts to help many people, thanks very much. There are some **Pull Request categories** that you can make : |
|||
|
|||
#### 1. Bugfix |
|||
|
|||
Di mana Anda membantu dalam **perbaikan error** yang dilaporkan oleh kontributor lain melalui [**Issue**](https://github.com/nafiesl/free-pmo/issues). Jika perbaikan error ini berkaitan dengan interaksi ke database (CRUD Operation), mohon agar Anda : |
|||
You help in the bugfix (error fixing) that reported by other contributors through Issue. If this bugfix is related **database interaction** (CRUD Operation) or **form submission**, please fulfill these requirements : |
|||
|
|||
1. Membuat **testing**, terkait fitur yang memiliki bug. |
|||
2. Pastikan **semua testing passed** pada saat Anda melakukan **pull request**. |
|||
1. Create **tests**, related to fixed bug. |
|||
2. Make sure **all tests are passed** when you create **Pull Request** (assisted by [travis-ci](https://travis-ci.org)). |
|||
|
|||
Kita akan review sama-sama terhadap perubahan yang Anda lakukan. Sekedar memastikan tidak ada konflik yang terjadi saat **pull request** ini disetujui. |
|||
We will review your changes together. Just to make sure thare are no conflict that effect on existing features when your **Pull Request** are merged. |
|||
|
|||
#### 2. Kesalahan Penulisan |
|||
#### 2. Typo Fix |
|||
|
|||
Pada project ini sangat mungkin terjadi kesalahan penulisan pada `halaman web` software, bagian `komentar`, `dokumentasi`, maupun pada file `lang` yang banyak kita gunakan pada sistem. Jika Anda menemukan kesalahan itu, silakan lakukan **pull request** untuk kita perbaiki sama-sama. |
|||
Very likely we have some typos on the software `web pages`, source code `comments`, `documentation` files, or on `lang` file that we use widely on the system. If you want to contribute to fix the **typo** on this project, please create new **Pull Request** to fix it, we will review it together. |
|||
|
|||
#### 3. New Feature |
|||
|
|||
Jenis **pull request** ini akan menambahkan fitur baru pada Free PMO. Jika Anda ingin melakukan pull request jenis ini, kami harapkan agar memenuhi ketentuan berikut : |
|||
This **Pull Request** will create **new feature** on Free PMO project. If you want to create this type of **Pull Request**, please be sure that you meet these requirements : |
|||
|
|||
1. Fitur baru sudah diusulkan dan dibahas sebelumnya pada [**Issue**](https://github.com/nafiesl/free-pmo/issues). |
|||
2. Fitur tambahan dilengkapi dengan Feature Test atau Unit Test sesuai keperluan (terutama jika ada interaksi perubahan pada database). |
|||
3. Semua **testing passed**. |
|||
1. The new feature has been [proposed and discussed on **Issue**](#new-feature-proposal). |
|||
2. New features that has any **database interaction** or **form submission** requires **Feature Test** and/or **Unit Test**. |
|||
3. All **tests are passed** (assisted by [travis-ci](https://travis-ci.org)). |
|||
|
|||
Kita akan **review dan uji** fitur baru tersebut sebelum **pull request** disetujui. |
|||
We will **review and test** your new feature **Pull Request** before it merged to master branch. |
|||
|
|||
> **Catatan** |
|||
> **Notes** |
|||
> |
|||
> Jika pada fitur baru terdapat **perubahan struktur** pada tabel yang sudah ada, silakan **langsung ubah pada file migration** yang bersangkutan, karena aplikasi Free PMO masih dalam tahap pengembangan. **Misal**: fitur baru memerlukan perubahan struktur tabel `payments`, silakan update file `2016_11_15_151228_create_payments_table.php`. |
|||
> If you **change** some **table structure** on new feature, just change corresponding **migration file** directly (since this project is still in development). **For example**: your new feature need have some `payments` table structure changes, just update `2016_11_15_151228_create_payments_table.php` migration file directly. |
|||
> |
|||
> Kemudian **mohon** diinformasikan **script sql** dari perubahan struktur tabel tersebut melalui **Komentar Commit** yang bersangkutan (seperti [contoh ini](https://github.com/nafiesl/free-pmo/commit/a813524f680e9926d64f1006a1c615acf86c24f1#commitcomment-26166267)). Hal ini dilakukan untuk mempermudah pengguna Free PMO existing jika ingin meng-update aplikasinya. |
|||
|
|||
> Then **please** inform the **alter table sql script** (of table structure changes) through **commit comment** (like [this example](https://github.com/nafiesl/free-pmo/commit/a813524f680e9926d64f1006a1c615acf86c24f1#commitcomment-26166267)). So existing Free PMO users can update their table structure easily. |
|||
|
|||
#### 4. Lang File |
|||
|
|||
Jenis **pull request** ini akan menambahkan **lang** file pada direktori `resources/lang` sesuai dengan konfigurasi `locale`-nya (misal `lang/en` untuk Bahasa Inggris). Saat ini file-file `lang` yang lengkap hanya pada direktori `locale` `id` untuk Bahasa Indonesia. |
|||
|
|||
Jika Anda ingin menambahkan bahasa locale lainnya, terutama `locale` `en` (Bahasa Inggris). Silakan melakukan **pull request** untuk kita **review** bersama. |
|||
This type of **Pull Request** will add new **lang** files on `resources/lang` directory based on system `locale` configuration (eg: `lang/en` for English). Currenty, we have `lang` files only in `id` for Bahasa Indonesia and `en` for English. |
|||
|
|||
### Kontribusi Donasi |
|||
If you are considering to create/add another language based on your locale or want to fix existing `lang` files. Please create new **Pull Request** so web can **review** it together. |
|||
|
|||
Free PMO adalah software management project yang bebas (merdeka) dan gratis. **Pengembang sudah ridho** jika Anda menggunakan dan memodifikasinya untuk tujuan pribadi maupun komersil (sesuai dengan [lisensi](LICENSE)). |
|||
### Donation |
|||
|
|||
Tetapi jika ada merasa sangat terbantu dengan software ini, dan berniat untuk mendonasikan sebagai rezeki Anda kepada pengembang, silakan mengirimkan donasi melalui jalur berikut : |
|||
Just for reminder, Free PMO is free and open-sourced project management software under [MIT license](LICENSE). It doesn't matter if you want to **use or modify** this project for **private or commercial** purposes as long as you do not remove the [license](LICENSE) file from the project. |
|||
|
|||
If you are considering to donate for this project development, you can send your donation via : |
|||
|
|||
#### Rekening Transfer |
|||
#### Bank Transfer (Indonesian Bank) |
|||
|
|||
| No. Rekening | BCA // 7820088543 | |
|||
| Account Number | BCA // 7820088543 | |
|||
| --- | --- | |
|||
| Atas nama | **Nafies Luthfi** | |
|||
| Kode Transfer | 014 | |
|||
| Account Name | **Nafies Luthfi** | |
|||
| Transfer Code | 014 | |
|||
|
|||
#### atau |
|||
#### or |
|||
|
|||
[](https://www.paypal.me/nafiesl/) |
|||
|
|||
Terima kasih banyak saya ucapan. |
|||
|
|||
### Penutup |
|||
|
|||
Terima kasih atas kontribusinya, semoga menjadi kebaikan untuk semua. |
|||
Thank you, again, for considering to contribute for Free PMO project. |
|||
|
|||
Salam hangat, |
|||
Best Regards, |
|||
|
|||
<br> |
|||
Nafies Luthfi, |
|||
Pengembang Free PMO |
|||
Free PMO Developer |
|||
Write
Preview
Loading…
Cancel
Save
Reference in new issue