Update README

Author: aleguy02

README.md

@@ -1,82 +1,81 @@
 <!-- TODO: review this and rewrite for accessibility if needed -->
+
 ![Socialify image](https://socialify.git.ci/aleguy02/GDocify/image?description=1&language=1&logo=https%3A%2F%2Fencrypted-tbn0.gstatic.com%2Fimages%3Fq%3Dtbn%3AANd9GcRNt8D27z6TIINfXpS5f7-_1wp_UVyfmCptTA%26s&name=1&owner=1&stargazers=1&theme=Light)
 
-# GDocify
+Upload all your plaintext files to Google Drive with **GDocify**. This app integrates with the Google Docs API and Google Drive API, allowing you to convert .txt files into Google Docs and upload them to a specific folder of your choice.
 
-GDocify integrates with the **Google Docs API** and **Google Drive API**, allowing you to convert .txt files into Google Docs and upload them to a folder. The project is designed to be forked and configured by users via the Google Cloud Platform.
+## Prerequisites
 
----
+Ensure you have a stable version of Node.js and Git installed on your system (tested with npm version 10.8.2) and a free Google Cloud Platform Account. This is required for API setup and credential configuration but, fortunately, easy to set up.
 
-## Prerequisites
+## Setup Instructions
 
-Ensure you have a stable version of Node.js and Git installed on your system (tested with npm version 10.8.2). Free Google Cloud Platform Account. Required for API setup and credential configuration.
-<!-- TODO: break this step down so I don't scare people away -->
+### Fork the Repository
 
----
+Fork this repository to your GitHub account, then clone the forked repository to your local machine:
 
-## Setup Instructions
+```bash
+git clone https://github.com/your-username/GDocify.git
+cd GDocify
+```
 
-### 1. Fork the Repository
+### Set Up Google Cloud Project
 
-1. Fork this repository to your GitHub account.
-2. Clone the forked repository to your local machine:
-   ```bash
-   git clone https://github.com/your-username/GDocify.git
-   cd GDocify
-   ```
+First, sign into or create a free [Google Cloud Platform](https://console.cloud.google.com/) account, then create a new project. Or, click this link to go straight to the New Project page: \
+https://console.cloud.google.com/projectcreate \
+Name the project GDocify or whatever other name you want. You can leave the location as "No organization".
+
+Next, enable the Google Drive and Google Docs APIs.
+
+1. Select Hamburger Menu<br>
+   <img src="doc/images/Hamburger.png" width="400">
+1. Select View All Products, then APIs & Services<br>
+   <img src="doc/images/APIsAndServices.png" width="400">
+1. Select ENABLE APIS AND SERVICES<br>
+   <img src="doc/images/EnableAPIS.png" width="400">
+1. Search for Google Drive API, select it, then select ENABLE. Do the same for Google Docs API<br>
+   <img src="doc/images/EnableButton.png" width="400">
 
 ---
 
-### 2. Set Up Google Cloud Project
+### Configure OAuth Consent Screen
 
-#### a) Create a Google Cloud Project
+Before you can use your app, you must configure the OAuth Consent Screen.
 
-1. Visit the [Google Cloud Console](https://developers.google.com/workspace/guides/create-project#google-cloud-console).
-2. Create a new project.
+1. From APIs & Services, navigate to OAuth Consent Screen<br>
+   <img src="doc/images/OAuth.png" height="250"><br>
+1. Select External for User Type, then select the Create button. In the "OAuth consent screen" page, fill out the following then select SAVE AND CONTINUE.
 
-#### b) Enable APIs
+   - `App name` as GDocify or whatever other name you want
+   - `User support email` with your email
+   - `Email addresses` with your email
 
-1. Navigate to:
-   <!-- TODO: insert screenshot here -->
-   **Hamburger Menu** → **All Products** → **Management** → **APIs and Services** → **+Enable APIs and Services**.
-2. Search for and enable:
-   - **Google Drive API**
-   - **Google Docs API**
+1. In the "Scopes" page, select ADD OR REMOVE SCOPES<br>
+   <img src="doc/images/AddOrRemoveScopes.png" width="400">
 
----
+1. Manually the following scopes by copying and pasting these links into the input box at the bottom and selecting ADD TO TABLE:
 
-### 3. Configure OAuth Consent Screen
-
-1. Go to:
-   <!-- TODO: insert screenshot here -->
-   **Hamburger Menu** → **All Products** → **Management** → **APIs and Services** → **OAuth Consent Screen**.
-2. Select **User Type**: **External**, then **Create**.
-3. Fill out the following:
-   - **App Name**: [GDocify]
-   - **Support Email**: [Your Email]
-   - **Developer Contact Info**: [Your Contact Email]
-4. Click **Save and Continue**.
-5. Add the following **Scopes**:
    - `https://www.googleapis.com/auth/documents`
    - `https://www.googleapis.com/auth/drive`
-6. Click **Save and Continue**.
-7. Under **Test Users**, add your email address.
 
----
+     <img src="doc/images/AddToTable.png" width="400">
 
-### 4. Configure OAuth Credentials
+1. Verify the `.../auth/documents` and `.../auth/drives` boxes are checked, then select UPDATE then SAVE AND CONTINUE
+   <img src="doc/images/Checkboxes.png" width="400">
 
-1. Navigate to:
-   <!-- TODO: insert screenshot here -->
-   **Hamburger Menu** → **All Products** → **Management** → **APIs and Services** → **Credentials**.
-2. Click **+Create Credentials** → **OAuth Client ID**.
-3. Select **Application Type**: **Desktop app**.
-4. Name it `[Your App Name] Desktop App` (e.g. `aleguy02 Desktop App`), then **Create**.
-5. Download the JSON file:
-   - Rename it to `credentials.json`.
-   - Move `credentials.json` into the `config` directory.
+1. In the "Test users" page, select ADD USERS and input your email. Select ADD then SAVE AND CONTINUE
+1. Review the "Summary" page before selecting BACK TO DASHBOARD
 
----
+### Configure OAuth Credentials
+
+1. From APIs & Services, navigate to Credentials<br>
+   <img src="doc/images/Credentials.png" height="250">
+1. Select CREATE CREDENTIALS then OAuth Client ID<br>
+   <img src="doc/images/CreateCredentials.png" width="400">
+1. Under `Application type`, select Desktop app. Then, select CREATE. OPTIONAL: Change name to whatever you want
+1. Once your OAuth client is created, select DOWNLOAD JSON<br>
+   <img src="doc/images/DownloadJSON.png" height="250">
+1. Rename the downloaded file to `credentials.json` and move it into the repo's `config` directory.
 
 ## Usage Instructions
 
@@ -89,17 +88,13 @@ Ensure you have a stable version of Node.js and Git installed on your system (te
    const FOLDER_NAME = "YourFolderName";
    ```
 
-   **Note**: Google Drive doesn't enforce unique folder names. If multiple folders share the same name, the script retrieves the folder ID of the most recently modified folder by the user.
-
----
+   **Note**: Google Drive doesn't enforce unique folder names. If multiple folders share the same name, the script retrieves the folder ID of the most recently modified folder by the user. I plan to implement paths to select folders in future updates.
 
 ### Step 2: Set Up NOTES folder
 
 1. Open your `NOTES` folder. Delete `Oh, the Places You'll Go!.txt`.
 2. Move or paste all the .txt files you want to upload into the `NOTES` folder
 
----
-
 ### Step 3: Run the Project
 
 1. Open your terminal and navigate to the project's root directory.
@@ -110,17 +105,14 @@ Ensure you have a stable version of Node.js and Git installed on your system (te
 
 This command executes the script, interacting with the Google Docs and Drive APIs as configured.
 
----
-
 ## Notes
 
 - If the folder name specified in `index.js` does not exist in your Google Drive the script will throw an error.
 - Be cautious of quota limits for Google Drive and Docs API usage.
 
----
-
-## Resources
+## Helpful Resources
 
+- [Creating a Google Cloud Project](https://developers.google.com/workspace/guides/create-project#google-cloud-console)
 - [Google Docs API Documentation](https://developers.google.com/docs)
 - [Google Drive API Documentation](https://developers.google.com/drive)
 - [Node.js Documentation](https://nodejs.org/en/docs)