Documentation Comments

1. write an essay about why we should make Documentation Comments, define some cases and select appropiate documentation
   scenario to solve those case, explain why.
    Dalam Sebuah komentar , komentar ikut serta dalam membuat program menjadi
    lebih mudah dibaca manusia dangan menempatkan detail kode yang terlibat
    dan penggunaan komentar yang tepat membuat perawatan
    lebih mudah dan menemukan bug dengan mudah.

    1. Single-line Comments
        fungsinya untuk menggambarkan fungsi kode.
    2. Multi-line Comments
        Untuk mennulis kan komentar yang lebih dari baris.
    3. Documentation Comments
        Untuk menulis dokumentasi untuk menuliskan
        detail program.

2. write a simple code to show data Documentation Comments in action.


// Single – line comments.
// Pemograman Java Untuk Menampilkan Data Diri

/**
 * Multi-line Comments
 * <h1> Masukkan Nama Anda dan Keluarga Anda <h1>
 * Program ini berfungsi untuk untuk
 * menampilkan form data diri
 * untuk satu keluarga sehingga
 * tida perlu menyimpan satu per satu
 * karna form ini telah di siap kan
 * untuk satu keluarga yang akan
 * di isi untuk user agar lebih mudah
 *
 * @author      rahmad
 * @version     1.0
 * @since       2019-02-01
 */

public class DataDiri
{
    /**
     * Method ini untuk Menuntukan Jenis type data apa yang akan di panggil
     *
     * @private untuk membuat member hanya bisa diakses oleh dari dalam class itu sendiri
     * @String  untuk menentukan bahwa data tersebut berbenruk teks
     * @int     untuk menentukan bahwa data tersebut berbentuk bilangan bulat
     *
     */
    private String Nama;            private String Panggilan;       private String JenisKelamin;
    private String TempatLahir;     private String TanggalLahir;    private String AlamatAsal;
    private String AlamatSekarang;  private String NoTelepon;       private String Email;
    private String Facebook;        private String Hobi;            private String PendidikanTerakhir;
    private String Pekerjaan;       private String Organisasi;      private String Jabatan;

//  Method yang tidak jadi di pakai
//  public DataDiri(String Nama, String Panggilan, String JenisKelamin, String TempatLahir,
//                  int TanggalLahir, String AlamatAsal, String AlamatSekarang, int NoTelepon,
//                  String Email, String Facebook, String Hobi, String PendidikanTerakhir,
//                  String Pekerjaan, String Organisasi, String Jabatan)
    {
        this.Nama = Nama;                 this.TempatLahir = TempatLahir;   this.AlamatSekarang = AlamatSekarang;
        this.Panggilan = Panggilan;       this.TanggalLahir = TanggalLahir; this.NoTelepon = NoTelepon;
        this.JenisKelamin = JenisKelamin; this.AlamatAsal = AlamatAsal;     this.Email = Email;
        this.Facebook = Facebook;         this.Hobi = Hobi;                 this.PendidikanTerakhir = PendidikanTerakhir;
        this.Pekerjaan = Pekerjaan;       this.Organisasi = Organisasi;     this.Jabatan = Jabatan;

    }

    /*
     * Method setter dan getter adalah dua method yang
     * tugas nya untuk mengambil dan mengisi data ke
     * dalanm objek.
     */
    public String getNama()
    {
        return Nama;
    }

    public void setNama(String nama)
    {
        Nama = nama;
    }

    public String getPanggilan()
    {
        return Panggilan;
    }

    public void setPanggilan(String panggilan)
    {
        Panggilan = panggilan;
    }

    public String getJenisKelamin()
    {
        return JenisKelamin;
    }

    public void setJenisKelamin(String jenisKelamin)
    {
        JenisKelamin = jenisKelamin;
    }

    public String getTempatLahir()
    {
        return TempatLahir;
    }

    public void setTempatLahir(String tempatLahir)
    {
        TempatLahir = tempatLahir;
    }

    public String getTanggalLahir()
    {
        return TanggalLahir;
    }

    public void setTanggalLahir(String tanggalLahir)
    {
        TanggalLahir = tanggalLahir;
    }

    public String getAlamatAsal()
    {
        return AlamatAsal;
    }

    public void setAlamatAsal(String alamatAsal)
    {
        AlamatAsal = alamatAsal;
    }

    public String getAlamatSekarang()
    {
        return AlamatSekarang;
    }

    public void setAlamatSekarang(String alamatSekarang)
{
        AlamatSekarang = alamatSekarang;
    }

    public String getNoTelepon()
    {
        return NoTelepon;
    }

    public void setNoTelepon(String noTelepon)
    {
        NoTelepon = noTelepon;
    }

    public String getEmail()
    {
        return Email;
    }

    public void setEmail(String email)
    {
        Email = email;
    }

    public String getFacebook()
    {
        return Facebook;
    }

    public void setFacebook(String facebook)
    {
        Facebook = facebook;
    }

    public String getHobi()
    {
        return Hobi;
    }

    public void setHobi(String hobi)
    {
        Hobi = hobi;
    }

    public String getPendidikanTerakhir()
    {
        return PendidikanTerakhir;
    }

    public void setPendidikanTerakhir(String pendidikanTerakhir)
    {
        PendidikanTerakhir = pendidikanTerakhir;
    }

    public String getPekerjaan()
    {
        return Pekerjaan;
    }

    public void setPekerjaan(String pekerjaan)
    {
        Pekerjaan = pekerjaan;
    }

    public String getOrganisasi()
    {
        return Organisasi;
    }

    public void setOrganisasi(String organisasi)
    {
        Organisasi = organisasi;
    }

    public String getJabatan()
    {
        return Jabatan;
    }

    public void setJabatan(String jabatan)
    {
        Jabatan = jabatan;
    }
}

// Method untuk menscan data yang ditulis oleh user
import java.util.Scanner;
public class CetakDatadiri
{
    public static void main(String[] args)
    {
        Scanner s = new Scanner(System.in);


        DataDiri data = new DataDiri();
        // untuk membuat perulangan agar tidak berulang menyimpan
        // data agar data nya sekali menyimpan saja
        for(int i = 1; i <= 4; i++)
        {
            /** Untuk menampilkan list list apa saja yang harus
             *  diisi berupa form formulir
             */

            System.out.println("\nFORM PENDAFTARAN DONOR DARAH");
            System.out.println("================================\n");


            System.out.print("Nama Lengkap               = ");
            String in = s.nextLine();
            data.setNama(in);


            System.out.print("Nama Panggilan             = ");
            String in1 = s.nextLine();
            data.setPanggilan(in1);


            System.out.print("Jenis Kelamin              = ");
            String in2 = s.nextLine();
            data.setPanggilan(in2);


            System.out.print("Tempat Lahir               = ");
            String in3 = s.nextLine();
            data.setTempatLahir(in3);


            System.out.print("Tanggal Lahir              = ");
            String in4 = s.nextLine();
            data.setTanggalLahir(in4);


            System.out.print("Alamat Asal                = ");
            String in5 = s.nextLine();
            data.setAlamatAsal(in5);


            System.out.print("Alamat Sekarang            = ");
            String in6 = s.nextLine();
            data.setAlamatSekarang(in6);


            System.out.print("Nomor Telepon              = ");
            String in7 = s.nextLine();
            data.setNoTelepon(in7);


            System.out.print("E-mail                     = ");
            String in8 = s.nextLine();
            data.setEmail(in8);


            System.out.print("Facebook                   = ");
            String in9 = s.nextLine();
            data.setFacebook(in9);


            System.out.print("Hobi                       = ");
            String in10 = s.nextLine();
            data.setHobi(in10);


            System.out.print("Pendidikan Terakhir        = ");
            String in11 = s.nextLine();
            data.setPendidikanTerakhir(in11);


            System.out.print("Pekerjaan                  = ");
            String in12 = s.nextLine();
            data.setPekerjaan(in12);


            System.out.print("Organi Sasi Yang Diikuti   = ");
            String in13 = s.nextLine();
            data.setOrganisasi(in13);


            System.out.print("Jabatan Dalam Organisasi   = ");
            String in14 = s.nextLine();
            data.setJabatan(in14);
        }


    }
}