Updated kdoc

app/src/main/java/fr/free/nrw/commons/upload/FailedUploadsAdapter.kt

@@ -17,7 +17,14 @@ import fr.free.nrw.commons.R
 import fr.free.nrw.commons.contributions.Contribution
 import java.io.File
 
-
+/**
+ * Adapter for displaying failed uploads in a paginated list in FailedUploadsFragment. This adapter
+ * binds the data from [Contribution] objects to the item views in the RecyclerView, allowing users to view
+ * details of failed uploads, retry them, or delete them.
+ *
+ * @param callback The callback to handle user actions such as Delete Uploads and Restart Uploads
+ * on failed uploads.
+ */
 class FailedUploadsAdapter(callback: Callback) :
     PagedListAdapter<Contribution, FailedUploadsAdapter.ViewHolder>(ContributionDiffCallback()) {
     private var callback: Callback = callback

app/src/main/java/fr/free/nrw/commons/upload/PendingUploadsAdapter.kt

@@ -18,7 +18,13 @@ import fr.free.nrw.commons.contributions.Contribution
 import timber.log.Timber
 import java.io.File
 
-
+/**
+ * Adapter for displaying pending uploads in a paginated list in PendingUploadsFragment. This adapter
+ * binds data from [Contribution] objects to the item views in the RecyclerView, allowing users to
+ * view details of pending uploads and perform actions such as deleting them.
+ *
+ * @param callback The callback to handle user actions such as Delete Uploads on pending uploads.
+ */
 class PendingUploadsAdapter(private val callback: Callback) :
     PagedListAdapter<Contribution, PendingUploadsAdapter.ViewHolder>(ContributionDiffCallback()) {
 

app/src/main/java/fr/free/nrw/commons/upload/UploadProgressActivity.kt

@@ -104,6 +104,14 @@ class UploadProgressActivity : BaseActivity() {
         return true
     }
 
+    /**
+     * Updates the menu items based on the current position in the view pager and the visibility
+     * of icons related to pending or failed uploads. This function dynamically modifies the menu
+     * to display pause, resume, retry, and cancel options depending on the state of the uploads.
+     *
+     * @param currentPosition The current position in the view pager. A value of `0` indicates
+     * pending uploads, while `1` indicates failed uploads.
+     */
     fun updateMenuItems(currentPosition: Int) {
         if (menu != null) {
             menu!!.clear()