update documentation

Author: VipulMascarenhas

ai-hub/ai-document-converter/README.md

@@ -1,5 +1,6 @@
 # AI Document Converter App
 
+## Overview
 
 AI Document Converter is an AI-powered solution designed to transform complex PDF documents into clean, structured Markdown. It goes beyond simple text extraction by preserving headings, tables, lists, images, and semantic structure, making documents immediately usable for downstream applications.
 
@@ -15,29 +16,19 @@ Key capabilities include:
 In short, the AI Document Converter helps enterprises unlock the full value of their documents by making them searchable, analyzable, and AI-ready.
 
 
-## Deploy solution on OCI
+## Deployment
 This application can be  deployed using an [Oracle Resource Manager](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Concepts/resourcemanager.htm) (ORM) stack as a solution on AI Hub.  To create and deploy the solution, click the button below:
 
 [![Deploy to Oracle Cloud][magic_button]][magic_stack]
 
 
-## Step-by-Step Deployment Process
-
-todo: 
-- add screenshots of the stack setup and describe the steps
-
-## User Interface
-
-todo: 
-- add screenshot of UI and describe actions user can take
-
-
 ## APIs
 
-todo: 
-- add instructions on where user can find the API swagger docs.
-- add examples of APIs that user can access 
+The APIs include:
+* Converting a PDF from object storage to Markdown.
+* Converting a PDF file uploaded as file object to Markdown.
 
+Please see the API reference `/api/docs` for more details to try them out.
 
 
 [magic_button]: https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg

ai-hub/ai-translation/README.md

@@ -1,20 +1,32 @@
-# AI Translation App
+# AI Translation
 
-todo: add high level details about the solution 
+## Overview
 
+The AI Text Translation Solution delivers fast, accurate language translation powered by state-of-the-art Large Language Models (LLM). By default, it leverages the powerful meta.llama-3.3-70b-instruct model from the OCI Generative AI Service , but you can specify alternative LLMs or connect any OpenAI-compatible model endpoint.
 
-## Deploy solution on OCI
-This application can be  deployed using an [Oracle Resource Manager](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Concepts/resourcemanager.htm) (ORM) stack as a solution on AI Hub.  To create and deploy the solution, click the button below:
-
-[![Deploy to Oracle Cloud][magic_button]][magic_stack]
-
+The solution includes REST APIs and Playground UI for experimentation.
 
+## Features
 
+🌐 APIs for translation and language management  
+🎛️ Playground UI for rapid hands-on exploration  
+📝 Single & Batch Translation support  
+🚀 Streaming & Async translation modes  
+🔗 Flexible model selection: supports OCI Generative AI and any OpenAI-compatible API
 
+## Deployment
+This application can be  deployed using an [Oracle Resource Manager](https://docs.oracle.com/en-us/iaas/Content/ResourceManager/Concepts/resourcemanager.htm) (ORM) stack as a solution on AI Hub.  To create and deploy the solution, click the button below:
 
+[![Deploy to Oracle Cloud][magic_button]][magic_stack]
 
+## APIs
 
+The APIs include:
+* Listing the supported languages
+* Text translation supporting streaming and async operations
+* Start batch Translation Job
 
+Please see the API reference `/api/docs` for more details and try them out.
 
 [magic_button]: https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg
 [magic_stack]: https://cloud.oracle.com/resourcemanager/stacks/create?zipUrl=https://github.com/oracle-samples/oci-data-science-ai-samples/releases/download/1.0/ai-translation.zip