Refactor models information for qkca (#4130)

Updating information for models available to use in the Qiskit Code
Assistant. As well as the table indicating the version to which each
model was trained for.

---------

Co-authored-by: abbycross <[email protected]>

Author: eltonjohnfanboy

docs/guides/qiskit-code-assistant-local.mdx

@@ -24,18 +24,47 @@ The Open Source Qiskit Code Assistant models are available in <DefinitionTooltip
 
 Follow these steps to download any Qiskit Code Assistant-related model from the Hugging Face website:
 
-1. Navigate to the desired Qiskit model page in
-1. Go to the Files and Versions tab and download the safetensors or GGUF model files.
-
-Publicly available open source models:
-1. [qiskit/granite-3.3-8b-qiskit](https://huggingface.co/Qiskit/granite-3.3-8b-qiskit). Released June 2025.
-1. [qiskit/granite-3.3-8b-qiskit-GGUF](https://huggingface.co/Qiskit/granite-3.3-8b-qiskit-GGUF). Released June 2025. Recommended for use in personal environments/laptops
-1. [qiskit/granite-3.2-8b-qiskit](https://huggingface.co/Qiskit/granite-3.2-8b-qiskit). Released June 2025.
-1. [qiskit/granite-3.2-8b-qiskit-GGUF](https://huggingface.co/Qiskit/granite-3.2-8b-qiskit-GGUF). Released June 2025. Recommended for use in personal environments/laptops
-1. [qiskit/qwen2.5-coder-14b-qiskit](https://huggingface.co/Qiskit/qwen2.5-coder-14b-qiskit). Released June 2025.
-1. [qiskit/qwen2.5-coder-14b-qiskit-GGUF](https://huggingface.co/Qiskit/qwen2.5-coder-14b-qiskit-GGUF). Released June 2025. Recommended for use in personal environments/laptops
-1. [qiskit/granite-8b-qiskit-rc-0.10](https://huggingface.co/Qiskit/granite-8b-qiskit-rc-0.10). Released February 2025 (deprecated).
-1. [qiskit/granite-8b-qiskit](https://huggingface.co/Qiskit/granite-8b-qiskit). Released November 2024 (deprecated).
+1. Navigate to the desired Qiskit model page on Hugging Face
+2. Go to the **Files and Versions** tab and download the safetensors or GGUF model files
+
+### Available models
+
+#### Current models
+
+These are the latest recommended models for use with Qiskit Code Assistant:
+
+1. [Qiskit/mistral-small-3.2-24b-qiskit](https://huggingface.co/Qiskit/mistral-small-3.2-24b-qiskit) - Released October 2025
+2. [qiskit/qwen2.5-coder-14b-qiskit](https://huggingface.co/Qiskit/qwen2.5-coder-14b-qiskit) - Released June 2025
+3. [qiskit/granite-3.3-8b-qiskit](https://huggingface.co/Qiskit/granite-3.3-8b-qiskit) - Released June 2025
+4. [qiskit/granite-3.2-8b-qiskit](https://huggingface.co/Qiskit/granite-3.2-8b-qiskit) - Released June 2025
+
+#### GGUF models (recommended for personal environments/laptops)
+
+GGUF format models are optimized for local use and require fewer computational resources:
+
+1. [qiskit/qwen2.5-coder-14b-qiskit-GGUF](https://huggingface.co/Qiskit/qwen2.5-coder-14b-qiskit-GGUF) - Released June 2025  
+2. [qiskit/granite-3.3-8b-qiskit-GGUF](https://huggingface.co/Qiskit/granite-3.3-8b-qiskit-GGUF) - Released June 2025  
+3. [qiskit/granite-3.2-8b-qiskit-GGUF](https://huggingface.co/Qiskit/granite-3.2-8b-qiskit-GGUF) - Released June 2025
+
+#### Qiskit versions used for training
+
+| **Model** |  | **Benchmark Metrics** |  | **Release date** | **Trained on Qiskit version** |
+|---|---|---|---|---|---|
+|  | **QiskitHumanEval** | **QiskitHumanEval-Hard** | **HumanEval** |  |  |
+| **mistral-small-3.2-24b-qiskit** | 20.53 | 40.39 | 77.49 | **October 2025** | **2.1** |
+| qwen2.5-coder-14b-qiskit | 25.16 | 49.01 | 91.46 | June 2025 | 2.0 |
+| granite-3.3-8b-qiskit | 14.56 | 27.15 | 62.80 | June 2025 | 2.0 |
+| granite-3.2-8b-qiskit | 9.93 | 24.50 | 57.31 | June 2025 | 2.0 |
+| granite-8b-qiskit-rc-0.10 | 15.89 | 38.41 | 59.76 | February 2025 | 1.3 |
+| granite-8b-qiskit | 17.88 | 44.37 | 53.66 | November 2024 | 1.2 |
+
+
+#### Deprecated models
+
+These models are no longer actively maintained but remain available:
+
+1. [qiskit/granite-8b-qiskit-rc-0.10](https://huggingface.co/Qiskit/granite-8b-qiskit-rc-0.10) - Released February 2025 (deprecated)
+2. [qiskit/granite-8b-qiskit](https://huggingface.co/Qiskit/granite-8b-qiskit) - Released November 2024 (deprecated)
 
 </details>