From 5a1ddb29c56c087cb573c39106e15c7ffb252d62 Mon Sep 17 00:00:00 2001
From: Manny Colon <colonmanuel7@gmail.com>
Date: Thu, 10 Feb 2022 19:36:06 -0500
Subject: [PATCH 1/2] JS doc for useEdit

---
 src/components/file/useEdit.js | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

diff --git a/src/components/file/useEdit.js b/src/components/file/useEdit.js
index 12e2a4ef..9a4c3cc7 100644
--- a/src/components/file/useEdit.js
+++ b/src/components/file/useEdit.js
@@ -1,6 +1,19 @@
 import { useState } from 'react';
 import { updateContent } from '../..';
 
+/**
+ * Custom hook for editing content of translation helps resources
+ * @param {string} sha
+ * @param {string} repo
+ * @param {string} owner
+ * @param {string} token
+ * @param {object} config - config settings for fetches (timeout, cache, etc.)
+ * @param {string} branch - branch name.
+ * @param {string} author - author of the edit.
+ * @param {string} content - Edited/updated content.
+ * @param {string} message - Optional commit message.
+ * @param {string} filePath - file path, file path for the file being edited.
+ */
 export default function useEdit({
   sha,
   repo,
@@ -13,18 +26,21 @@ export default function useEdit({
   message,
   filepath,
 }) {
-  const [{ isEditing, isError, error, editResponse }, setState] = useState({
+  const initialState = {
     editResponse: null,
     isEditing: false,
     isError: false,
     error: null,
-  })
+  }
+  const [{ isEditing, isError, error, editResponse }, setState] = useState(initialState)
   const { name: tokenid } = token || {}
   const _message = message || `Edit '${filepath}' using '${tokenid}'`;
 
   async function onSaveEdit(_branch) {
     try {
+      // content is the updated string or dirty content.
       if (content) {
+        // clear state to remove left over state from a previous edit.
         setState((prevState) => ({
           ...prevState,
           editResponse: null,

From 5de131321e7d1ae820a110aa21b8afbaa0f4f4bf Mon Sep 17 00:00:00 2001
From: Manny Colon <colonmanuel7@gmail.com>
Date: Fri, 11 Feb 2022 12:08:53 -0500
Subject: [PATCH 2/2] Added  documentation for the return object of useEdit

---
 src/components/file/useEdit.js | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/components/file/useEdit.js b/src/components/file/useEdit.js
index 9a4c3cc7..568478f7 100644
--- a/src/components/file/useEdit.js
+++ b/src/components/file/useEdit.js
@@ -13,6 +13,7 @@ import { updateContent } from '../..';
  * @param {string} content - Edited/updated content.
  * @param {string} message - Optional commit message.
  * @param {string} filePath - file path, file path for the file being edited.
+ * @return {{error: object, isError: boolean, isEditing: boolean, onSaveEdit: (function(_branch: string)), editResponse: object}}
  */
 export default function useEdit({
   sha,