fix: some documentation fixes

Author: mrgiba

samples/contract-compliance-analysis/README.md

@@ -32,11 +32,11 @@ To deploy this project, follow the instructions available in the README files lo
 
 ## Key Features
 
-- **Automated Contract Analysis**: Validates, processes, classifies, and evaluates contract clauses against your guidelines with risk assessment
+- **AI-Assisted Contract Analysis**: Validates, processes, classifies, and evaluates contract clauses against your guidelines with risk assessment
 - **Multi-Language AI Analysis**: Generate analysis reports in English, Spanish, or Portuguese based on user selection
 - **Multi-Contract Type Support**: Define and manage multiple contract types (service agreements, employment contracts, etc.) with type-specific guidelines
 - **Web Application**: User interface for managing contract types, guidelines, and viewing analysis results
-- **AI-Generated Evaluation Questions**: Automatically create compliance questions from guideline definitions
+- **AI-Generated Evaluation Questions**: Generate compliance questions from guideline definitions
 - **Contract Import**: Bootstrap new contract types by extracting guidelines from reference contracts
 - **Configurable Risk Thresholds**: Customize risk classification criteria per contract type
 - **Flexible Model Selection**: Configure different foundation models for specific tasks via parameter store
@@ -45,7 +45,7 @@ To deploy this project, follow the instructions available in the README files lo
 
 ## Architecture
 
-This prototype leverages AWS managed services and Large Language Models to automate contract compliance analysis. The architecture consists of multiple workflows that work together to validate contracts against your guidelines and optionally verify compliance with legislation.
+This prototype leverages AWS managed services and Large Language Models to assist with contract compliance analysis. The architecture consists of multiple workflows that work together to validate contracts against your guidelines and optionally verify compliance with legislation.
 
 ### High-Level Architecture
 
@@ -67,7 +67,7 @@ When enabled, this workflow uses an AI agent with access to a knowledge base of
 
 ### Contract Import Workflow
 
-This workflow uses LLMs to automatically extract contract type information and guidelines from reference contracts, enabling rapid onboarding of new contract types without manual guideline creation:
+This workflow uses LLMs to extract contract type information and guidelines from reference contracts, enabling rapid onboarding of new contract types with reduced manual effort:
 
 ![Contract Import Architecture](./images/contract-import-architecture.png)
 

samples/contract-compliance-analysis/backend/README.md

@@ -218,7 +218,7 @@ Access these features through the frontend application after deployment.
 4. **Create a new contract type** or use the default "Service Agreement" type
 5. **Add guidelines** for your contract type using one of these approaches:
    - **Manual Entry**: Use the guidelines form to add clause types and evaluation questions
-   - **AI-Assisted Generation**: Automatically generate evaluation questions and review/edit as needed
+   - **AI-Assisted Generation**: Generate evaluation questions and review/edit as needed
    - **Import from Reference Contract**: Upload an existing contract to extract contract type, clause types, and initial guidelines (see below)
 
 ### Reference Contract Import

samples/contract-compliance-analysis/documentation/technical-documentation.adoc

@@ -15,7 +15,7 @@
 :revdate: {currentdate}
 :author: Technical Documentation
 
-= Automated Contract Compliance Analysis
+= Contract Compliance Analysis
 
 <<<
 // Table of Contents is automatically generated here
@@ -48,7 +48,7 @@ During the prototyping engagement/proof of concept, AWS may use third-party mode
 <<<
 == Overview
 
-This document details a solution prototype developed to automate the compliance analysis of contracts. The prototype leverages Generative Artificial Intelligence (GenAI) to evaluate contract clauses against predefined guidelines and provide feedback on their adherence to the required standards.
+This document details a solution prototype developed to assist legal teams in analyzing contract compliance. The prototype leverages Generative Artificial Intelligence (GenAI) to evaluate contract clauses against predefined guidelines and provide feedback on their adherence to the required standards.
 
 The prototype is powered by AWS Machine Learning services and a Large Language Model (LLM) capable of understanding legal terminology and concepts. Such a LLM is used to perform advanced natural language tasks, such as clause classification and compliance evaluation, based on the provided guidelines.
 
@@ -102,7 +102,7 @@ The prototype includes a web-based interface and REST APIs for managing contract
 * Create, update, and delete contract types through the UI
 * Define and manage guidelines for each contract type
 * Import guidelines from structured text using AI-powered extraction
-* Generate evaluation questions automatically using the LLM
+* Generate evaluation questions using the LLM
 
 This approach is recommended for production use as it provides a user-friendly interface and maintains data consistency through the application layer.
 
@@ -185,7 +185,7 @@ The script validates the JSON structure, checks for required fields, and imports
 
 Evaluation questions are binary questions used to assess whether a contract clause is compliant with the standard wording for a clause type. The prototype provides two methods for generating these questions:
 
-*API-Based Generation (Recommended)*: When creating or updating guidelines through the web interface, the system can automatically generate evaluation questions using the LLM, allowing immediate review and editing.
+*API-Based Generation (Recommended)*: When creating or updating guidelines through the web interface, the system can generate evaluation questions using the LLM, allowing immediate review and editing.
 
 *JSON File Definition*: For bulk imports, evaluation questions can be predefined in the JSON file, allowing version control and consistent evaluation criteria across environments.
 
@@ -199,7 +199,7 @@ The architecture consists of:
 
 * *Contract Analysis Workflow*: Orchestrated multi-step pipeline that processes contracts through validation, preprocessing, classification, evaluation, and risk assessment
 * *Guideline Management*: Storage and management of contract types, clause types, and evaluation criteria
-* *AI-Powered Import*: Automated extraction of guidelines from reference contracts using LLMs
+* *AI-Powered Import*: AI-assisted extraction of guidelines from reference contracts using LLMs
 
 ==== Optional Features
 
@@ -250,7 +250,7 @@ ifndef::env-github[]
 image::guidelines-compliance-architecture.png[width=90%,align=center]
 endif::[]
 
-The AI-powered import workflow automatically extracts contract types and guidelines from reference contracts:
+The AI-powered import workflow extracts contract types and guidelines from reference contracts:
 
 ifdef::env-github[]
 ++++
@@ -636,7 +636,7 @@ The agent has access to:
 
 === Contract Type and Guidelines Import Workflow
 
-The prototype provides an AI-powered workflow to automatically extract contract type definitions and guidelines from reference contract text. This eliminates the need for manual guideline creation and accelerates the setup of new contract types.
+The prototype provides an AI-powered workflow to extract contract type definitions and guidelines from reference contract text. This reduces manual effort in guideline creation and accelerates the setup of new contract types.
 
 ==== Import Workflow Steps
 
@@ -677,7 +677,7 @@ Through the web application:
 1. Navigate to Contract Types management
 2. Click "Import Contract Type"
 3. Paste the reference contract text (can be an existing contract that follows the desired structure)
-4. Submit - the AI workflow automatically extracts:
+4. Submit - the AI workflow extracts:
    - Contract type definition
    - All clause types with standard wording
    - Evaluation questions for each clause type
@@ -946,7 +946,7 @@ endif::[]
 
 1. Click "Import Contract Type"
 2. Paste a reference contract text (e.g., an existing contract that follows the desired structure)
-3. Submit - the AI automatically extracts:
+3. Submit - the AI extracts:
    - Contract type name and description
    - All clause types with standard wording
    - Impact levels for each clause type
@@ -1024,7 +1024,7 @@ ifndef::env-github[]
 image::frontend-edit-guideline.png[width=90%,align=center]
 endif::[]
 
-The guideline editor allows users to modify clause types, standard wording, impact levels, examples, and evaluation questions. The AI-powered "Generate Questions" feature automatically creates evaluation questions from the standard wording.
+The guideline editor allows users to modify clause types, standard wording, impact levels, examples, and evaluation questions. The AI-powered "Generate Questions" feature creates evaluation questions from the standard wording.
 
 *Editing Guidelines:*
 
@@ -1047,7 +1047,7 @@ Example: If standard wording mentions "30 days notice period", a generated quest
 
 Users can:
 
-- Generate questions automatically using AI
+- Generate questions using AI
 - Manually add/edit/remove questions
 - Ensure questions are specific and verifiable