Update file Developer Environment Guide for Linux.md

Author: Maha-Lakshmi-Soumya-Yalavarthi

docs/Developer Environment Guide for Linux.md

@@ -1,87 +1,92 @@
-# Development Environment Setup Guide on Linux
-# Introduction
-This guide establishes a cloud-based development environment using Amazon Linux 2023 on AWS EC2, specifically designed for the GenAI IDP accelerator.
+# Development Environment Setup Guide on Linux  
+# Introduction  
+This guide establishes a cloud-based development environment using Amazon Linux 2023 on AWS EC2, specifically designed for the GenAI IDP accelerator.  
 
-Purpose: Provides a standardized, scalable development infrastructure that combines the familiar VSCode interface on your local machine with powerful cloud compute resources. This approach eliminates local environment configuration issues while ensuring consistent development experiences across team members.
+Purpose: Provides a standardized, scalable development infrastructure that combines the familiar VSCode interface on your local machine with powerful cloud compute resources. This approach eliminates local environment configuration issues while ensuring consistent development experiences across team members.  
 
 When to use this guide:
-• You need a new development environment
-• Your current setup has configuration issues
-• You prefer cloud-based development with scalable resources
-• You want a clean, isolated environment for this project
+- You need a new development environment  
+- Your current setup has configuration issues  
+- You prefer cloud-based development with scalable resources  
+- You want a clean, isolated environment for this project  
 
-What you'll achieve: 
+What you'll achieve:  
 A hybrid development setup where your code runs on a pre-configured Amazon Linux EC2 instance while you work through VS Code on your local machine, providing both performance and consistency.
 
-## Step 1: Launch EC2 Instance
+# Step 1: Launch EC2 Instance
 
-# 1.1 Navigate to EC2 Console
+## 1.1 Navigate to EC2 Console
 1. Log into [AWS Management Console](https://console.aws.amazon.com/)
 2. Navigate to EC2 service
 3. Click Launch Instance
 
-# 1.2 Configure Instance Settings
-Name: genai-idp-dev-environment (example)
--AMI Selection:
--• **Amazon Linux 2023**
--Architecture: 64-bit (x86)
--Instance Type:
--• Heavy development: t3.2xlarge (8 vCPU, 32 GB RAM)(recommended)
--(Other instance types will also work, but this is one we tested)
+## 1.2 Configure Instance Settings
+Name: genai-idp-dev-environment(example)  
+AMI Selection:  
+**Amazon Linux 2023**   
+- Architecture: 64-bit (x86)
+Instance Type:  
+- Heavy development: t3.2xlarge (8 vCPU, 32 GB RAM)(recommended)  
+(Other instance types will also work, but this is one we tested)  
 
-# 1.3 Key Pair Setup
+## 1.3 Key Pair Setup
 1. Click Create new key pair (or select existing)
 2. Name: genai-idp-dev-key (example)
 3. Type: RSA
 4. Format: .pem
 5. Download and save the .pem file securely
 
-# 1.4 Network Settings
+## 1.4 Network Settings
 Security Group Configuration:
-1. Create new security group: genai-idp-dev-sg (example)
-2. Add these inbound rules:
-   • **SSH**: Port 22, Source: My IP
+1. Create new security group  
+2. Add these inbound rules:  
+  - **SSH**: Port 22, Source: My IP
 
-# 1.5 Storage Configuration
-• Size: 720 GiB (minimum 20GB)
-• Type: gp3
-• Delete on termination: Yes
+## 1.5 Storage Configuration
+- Size: 720 GiB    
+- Type: gp3  
+- Delete on termination: Yes
 
-# 1.6 Launch
+## 1.6 Launch
 Click Launch instance and wait for it to reach "Running" state.
 
-## Step 2: Connect to Your Instance
+# Step 2: Connect to Your Instance
 
-# Get Connection Info
+## Get Connection Info
 1. Select your instance in EC2 console
 2. Note the Public IPv4 address
 
-# SSH Connection Command
+## SSH Connection Command
 On local machine:
-# CMD Terminal
+### CMD Terminal
 ssh -i /path/to/genai-idp-dev-key.pem ec2-user@YOUR_INSTANCE_IP
+### To install git run this command on EC2 Instance  
+sudo dnf install git -y
 
-# Clone Repository
-bash
+### Clone Repository
 git clone https://github.com/aws-solutions-library-samples/accelerated-intelligent-document-processing-on-aws
 
-# Run the setup script
-./dev_setup.sh
-
-## Step 4: Install Visual Studio Code
-# 4.1 Visit the official website: Go to [https://code.visualstudio.com/](https://code.visualstudio.com/)
-Download: Click the "Download for Windows" button
-   • This will download the User Installer (recommended for most users)
-   • File name will be something like VSCodeUserSetup-x64-1.x.x.exe
-Install: 
-   • Run the downloaded installer
-   • Choose installation location (default is recommended)
+### Go to directory  
+ cd accelerated-intelligent-document-processing-on-aws/  
+
+### Run the setup script for development tools which is scripts directory
+cd  scripts
+sh ./dev_setup.sh
+
+# Step 4: Install Visual Studio Code on Local Machine
+## 4.1 Visit the official website: Go to [https://code.visualstudio.com/](https://code.visualstudio.com/)
+Download: Click the "Download for Windows" button  
+- This will download the User Installer (recommended for most users)  
+- File name will be something like VSCodeUserSetup-x64-1.x.x.exe  
+Install:   
+   - Run the downloaded installer  
+   - Choose installation location (default is recommended)  
 Launch: Click "Launch Visual Studio Code" when installation completes
 
 Install Remote - SSH extension (by Microsoft)
 
-# 4.2 Connect via VSCode: Update your SSH config
-Press Ctrl+Shift+P for commands
+## 4.2 Connect via VSCode: Update your SSH config
+Press Ctrl+Shift+P for commands  
 Append the following block to your ~/.ssh/config file:
 
 ```
@@ -96,41 +101,32 @@ Host genai-idp-dev
 1. Press Ctrl+Shift+P
 2. Type "Remote-SSH: Connect to Host"
 3. Select "genai-idp-dev"
-4. Open folder: /home/ec2-user//accelerated-intelligent-document-processing-on-aws
+4. Open folder: /home/ec2-user/accelerated-intelligent-document-processing-on-aws
 
-## Step 5: Setup
-
-### Setup Python Environment
-```bash
-# Create and activate virtual environment
-python3 -m venv venv
-source venv/bin/activate
-
-## Step6: Configure
+# Step 5: Configure
 For aws configure you need "access key" and "secret access key"
 If you have one use that or create access key
-1.In the AWS Console search bar, type "IAM"
-Click on "IAM" service
+1.In the AWS Console search bar, Click on "IAM" service  
 2.In the left sidebar, click "Users"
-Find and click on your username
-Click on the "Security credentials" tab 
-Scroll down to "Access keys" section
-3. Click "Create access key"
-4. Choose use case:
-   • **"Command Line Interface (CLI)"** - for development
-   • **"Local code"** - for applications
+- Find and click on your username  
+- Click on the "Security credentials" tab   
+- Scroll down to "Access keys" section
+3.Click "Create access key"
+4.Choose use case:
+  - **"Command Line Interface (CLI)"** - for development  
+  - **"Local code"** - for applications  
 5. Click "Next"
 6. Add description (optional): "Development Environment"
 7. Click "Create access key"
-8.Click "Download .csv file" to save both keys
-```bash
+8.Click "Download .csv file" to save both keys  
+
+### In VScode Terminal run this script
 aws configure
 
-### Test Build Process
-```bash
-# Test publish script help
+# Step 6: Run Publish Script 
+## Test Build Process
+### Test publish script help
 ./publish.sh --help
 
-# Test build (this will take 10-15 minutes)
-./publish.sh bucket_name build-test us-east-1
-```
+### Test build (this will take 10-15 minutes)
+./publish.sh bucket_name build-test us-east-1