docs: menambahkan dokumentasi format doxygen

Author: yusuf601

algorithm/sorting/insertion_sort.cpp

@@ -1,19 +1,42 @@
+/**
+ * @file insertion_sort.cpp
+ * 
+ * @author Muh Yusuf
+ * 
+ * @date July 2025
+ * 
+ * @brief Program untuk mengurutkan data menggunakan algoritma Insertion Sort (naik dan turun).
+ * 
+ * Program ini meminta pengguna memasukkan sejumlah bilangan bulat, lalu mengurutkan data
+ * tersebut dua kali: pertama secara menaik (ascending), lalu secara menurun (descending).
+ * Hasilnya akan ditampilkan di terminal.
+ */
 #include <iostream>
 #include <vector>
 using namespace std;
-//fungsi untuk menampilkan vector setelah sort secara Ascending(terkecil)
-void tampilkanAscending(vector<int>& value){
-    for(int i = 0; i < value.size(); i++){
-        cout << value[i] << " ";
+/**
+ * @brief Menampilkan elemen-elemen vector.
+ * 
+ * @param value Vector integer yang sudah di sort.
+ * 
+ * Menggunakan range-based loop dan `const reference` agar efisien.
+ */
+void tampilkan(const vector<int>& value){
+    for(const auto x: value){
+        cout << x << " ";
     }
 }
-//fungsi untuk menampilkan vector setelah sort secara Descending(terbesar)
-void tampilkanDescending(vector<int>& value){
-    for(int i = 0; i < value.size(); i++){
-        cout << value[i] << " ";
-    }
-}
-void InsertionSortAscending(vector<int>& value, int &key){  //insertion sort menaik
+/**
+ * @brief Mengurutkan elemen vector secara menaik (terkecil ke terbesar).
+ * 
+ * @param value Vector integer yang akan diurutkan.
+ * @param key Variabel untuk menyimpan nilai sementara (key).
+ * 
+ * Menggunakan algoritma Insertion Sort. Setiap iterasi menyisipkan `key` ke posisi yang tepat
+ * dengan menggeser elemen-elemen yang lebih besar ke kanan.
+ */
+void InsertionSortAscending(vector<int>& value){  //insertion sort menaik
+    int key;
     for(int i = 1;i < value.size(); i++){
         key = value[i]; //inialisasi bilangan kedua merupakan key(kunci)
         int j = i - 1;  //inialisasi j adalah bilangan pertama
@@ -25,6 +48,14 @@ void InsertionSortAscending(vector<int>& value, int &key){  //insertion sort men
         value[j + 1] = key; // Masukkan key pada posisi yang benar
     }
 }
+/**
+ * @brief Mengurutkan elemen vector secara menurun (terbesar ke terkecil).
+ * 
+ * @param value Vector integer yang akan diurutkan.
+ * 
+ * Insertion Sort dalam urutan descending: menyisipkan `key` di posisi yang benar
+ * dengan menggeser elemen yang lebih kecil ke kanan.
+ */
 void InsertionSortDescending(vector<int>& value) { //insertion sort menurun
     for(int i = 1; i < value.size(); i++) {
         int key = value[i]; // key adalah elemen yang akan disisipkan
@@ -37,24 +68,35 @@ void InsertionSortDescending(vector<int>& value) { //insertion sort menurun
         value[j + 1] = key; // Masukkan key pada posisi yang benar
     }
 }
+/**
+ * @brief Fungsi utama program.
+ * 
+ * @return int Status keluar dari program.
+ * 
+ * Alur program:
+ * - Meminta input jumlah elemen
+ * - Input data elemen
+ * - Melakukan sorting ascending dan menampilkan hasilnya
+ * - Melakukan sorting descending dan menampilkan hasilnya
+ */
 int main(){
     int count,input,key;
-    vector<int> value;
     //meminta user untuk memasukkan panjang data(vector)
     cout << "Masukkan panjang data: ";
     cin >> count;
+    vector<int> value(count);
     for(int i = 0;i <= count - 1 ; i++){
         cout << "Masukkan data ke " << i + 1 << ": ";
-        cin >> input;
-        value.push_back(input);
+        cin >> value[i];
+        
     }
     //menampilkan vector setelah sorting
-    InsertionSortAscending(value,key);
+    InsertionSortAscending(value);
     cout << "Data setelah di urut mulai dari terkecil ";
-    tampilkanAscending(value);
+    tampilkan(value);
     InsertionSortDescending(value);
     cout << "\ndata setelah di urut mulai terbesar ";
-    tampilkanDescending(value);
+    tampilkan(value);
     cin.get();
     return 0;
 }

algorithm/sorting/selection_sort.cpp

@@ -1,18 +1,58 @@
+/**
+ * @file insertion_sort.cpp
+ * 
+ * @authors Muh Yusuf
+ * 
+ * @date July 2025
+ * 
+ * @brief Program untuk mengurutkan array menggunakan algoritma Selection Sort.
+ * 
+ * Program ini meminta pengguna untuk memasukkan sejumlah elemen integer,
+ * lalu mengurutkannya dengan algoritma Selection Sort dan menampilkannya.
+ * 
+ * ### Detail Fitur:
+ * - Input panjang array dari pengguna
+ * - Input elemen-elemen array
+ * - Sorting dengan algoritma Selection Sort
+ * - Output array yang sudah diurutkan
+ * 
+ * ### Catatan:
+ * - Sorting dilakukan **in-place** menggunakan referencing
+ * - Penukaran elemen menggunakan fungsi `swap()`
+ * - Output dilakukan lewat fungsi `PrintVec()` untuk modularitas
+ */
+
 #include <iostream>
 #include <vector>
-#include <array>
 using namespace std;
 // Fungsi untuk menukar posisi dua elemen
 void swap(int *a, int *b) {
   int temp = *a;
   *a = *b;
   *b = temp;
 }
-void PrintVec(vector<int>& val){ //gunakan referencing
-    for(int print = 0; print < val.size(); print++){
-        cout << val[print] << " ";
+/**
+ * @brief Menampilkan elemen-elemen dari vector.
+ * 
+ * @param val Vector integer yang akan ditampilkan elemennya.
+ * 
+ * Fungsi ini menggunakan reference agar efisien dan tidak melakukan copy data.
+ */
+void PrintVec(const vector<int>& val){ //gunakan referencing
+    for(const auto x: val){
+        std::cout << x << " ";
     }
 }
+/**
+ * @brief Mengurutkan elemen-elemen dalam vector menggunakan algoritma Selection Sort.
+ * 
+ * @param val Vector integer yang akan diurutkan (secara ascending).
+ * 
+ * Selection Sort bekerja dengan mencari elemen terkecil dari sisa elemen yang belum
+ * terurut, lalu menukarnya dengan elemen pada posisi saat ini.
+ * 
+ * Kompleksitas waktu: O(n^2)
+ */
 void SelectionSort(vector<int>& val){  //gunakan referencing untuk menghindari banyak penggunaan variabel
     /*
     Lakukan iterasi untuk setiap elemen vector dengan i sebagai indeks elemen pertama.
@@ -38,17 +78,24 @@ void SelectionSort(vector<int>& val){  //gunakan referencing untuk menghindari b
         }
     }
 }
+/**
+ * @brief Fungsi utama program.
+ * 
+ * Mengatur alur eksekusi: meminta input dari user, memanggil fungsi sorting,
+ * dan menampilkan hasilnya.
+ * 
+ * @return int Status keluar dari program (0 berarti sukses).
+ */
 int main(){
     int value;
     int count;
-    vector<int> val;
     // meminta user untuk memasukkan panjang data vector
     cout << "Masukkan panjang data: ";
     cin >> count;
-    for(int i = 0; i <= count - 1 ; i++){
+    vector<int> val(count);
+    for(int i = 0; i < count; i++){
         cout << "Masukkan data ke " << i + 1 << ": ";
-        cin >> value;
-        val.push_back(value); //memasukkan nilai yg dimasukkan(value) ke vector val
+        std::cin >> val[i]; //memasukkan nilai yg dimasukkan(value) ke vector val
     }
     SelectionSort(val);
     cout << "sesudah sorting " << endl;