Update README.md

README.md

@@ -15,46 +15,73 @@ base_model: t5-base
 
 # Interview Question Generation Model (T5-base)
 
-This is a fine-tuned T5-base model that generates interview questions
-from job details such as job title, description, required experience,
-and skills.
+A fine-tuned **T5-base** model that generates interview questions from
+job details such as job title, description, required experience, and skills.
 
-It is designed for HR platforms, hiring tools, and interview preparation
-apps.
+Developed for HR platforms, hiring tools, and interview preparation apps.
+
+---
+
+## Model Description
+
+This model is based on **T5-base** (Text-to-Text Transfer Transformer).
+It was fine-tuned on a custom dataset of job descriptions paired with
+interview questions. The model takes a structured prompt as input and
+returns a single interview question as output.
+
+**Model type:** Encoder-decoder (T5)
+**Language:** English
+**License:** Apache 2.0
+**Fine-tuned from:** `t5-base`
+
+---
+
+## Highlights
+
+- **Text-to-text generation:** One input prompt → one interview question.
+- **Multi-role support:** Works for ML, backend, frontend, data, DevOps roles.
+- **Question-type control:** You can specify `Technical`, `Scenario`,
+  `Behavioral`, or `Problem-Solving`.
+- **Lightweight:** ~220M parameters, runs on CPU and GPU.
+- **Hugging Face ready:** Works with `transformers`, `pipeline`, and
+  the Hugging Face inference widget.
 
 ---
 
 ## Model Details
 
-- **Base model:** T5-base
-- **Architecture:** T5ForConditionalGeneration (encoder-decoder)
-- **Parameters:** ~220M
-- **Language:** English
-- **Fine-tuned on:** custom interview question dataset
-- **Task:** text-to-text generation
+| Attribute | Value |
+|---|---|
+| Base model | T5-base |
+| Architecture | T5ForConditionalGeneration |
+| Parameters | ~220M |
+| Model size | ~967 MB (float32) |
+| Context length | 512 tokens |
+| Vocab size | 32128 |
+| Fine-tuned on | Custom interview Q&A dataset |
+| Task | Text-to-text generation |
 
 ---
 
 ## Intended Use
 
-Use this model when you want to automatically generate a single
-interview question for a given job role.
-
-**Good for:**
-- HR screening tools
+**Direct use:**
+- HR platforms generating screening questions
 - Interview preparation apps
-- Recruitment automation
+- Recruitment automation tools
+- Educational content creation
 
-**Not good for:**
-- Generating full interview scripts
+**Out-of-scope use:**
 - Non-English languages
-- Legal or medical advice
+- Medical, legal, or financial advice
+- Long-form interview scripts
+- Automated hiring decisions without human review
 
 ---
 
 ## Input Format
 
-The model expects **one plain text prompt** in this exact format:
+The model expects **one plain text prompt** with the following structure:
 
 ```text
 Generate an interview question.