From 9063706ce250655ed7a589587b4e4fe3d8708d0f Mon Sep 17 00:00:00 2001
From: erfanzar <erfanzare82@yahoo.com>
Date: Tue, 28 May 2024 16:46:35 +0330
Subject: [PATCH] improving `documentations`

---
 README.md             |  2 +-
 docs/conf.py          |  1 +
 docs/index.rst        | 42 +++++++++++++++++++++++++-----------------
 docs/requirements.txt |  3 ++-
 4 files changed, 29 insertions(+), 19 deletions(-)

diff --git a/README.md b/README.md
index b4eadd9f5..937c6acd0 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ of machine learning models, particularly in the domain of large language models
 ## Documentation 💫
 
 > [!IMPORTANT]
-> Documents and Examples are ready at [Here](https://erfanzar.github.io/EasyDeL)
+> Documents and Examples are ready at [Here](https://easydel.readthedocs.io/en/latest/)
 > Please have that in mind that EasyDeL is in the loop of fast-development
 > so we might have API changes.
 
diff --git a/docs/conf.py b/docs/conf.py
index 16f156192..f918604b1 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -13,6 +13,7 @@
     "sphinx.ext.viewcode",
     "sphinx.ext.intersphinx",
     "sphinx_autodoc_typehints",
+    "myst_parser"
 ]
 
 templates_path = ["_templates"]
diff --git a/docs/index.rst b/docs/index.rst
index 7200b1e97..aa0b8af9f 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -88,39 +88,47 @@ Citing EasyDeL 🥶
 To cite this Project
 ---------------------------------------------------------------
 
-```misc
-@misc{Zare Chavoshi_2023,
-    title={EasyDeL, an open-source library, is specifically designed to enhance and streamline the training process of machine learning models. It focuses primarily on Jax/Flax and aims to provide convenient and effective solutions for training Flax/Jax Models on TPU/GPU for both Serving and Training purposes.},
-    url={https://github.com/erfanzar/EasyDeL},
-    journal={EasyDeL Easy and Fast DeepLearning with JAX},
-    publisher={Erfan Zare Chavoshi},
-    author={Zare Chavoshi, Erfan},
-    year={2023}
-} 
-```
+.. _EasyDeL:
+
+Zare Chavoshi, Erfan. "EasyDeL, an open-source library, is specifically designed to enhance and streamline the training process of machine learning models. It focuses primarily on Jax/Flax and aims to provide convenient and effective solutions for training Flax/Jax Models on TPU/GPU for both Serving and Training purposes." 2023. https://github.com/erfanzar/EasyDeL
 
 .. toctree::
     :hidden:
     :maxdepth: 1
     :caption: Getting Started
 
-    install
+    install.md
     contributing
+
 .. toctree::
     :hidden:
     :maxdepth: 1
     :caption: EasyDeL Magics
 
-    easydelstate
+    easydelstate.md
 
 .. toctree::
     :hidden:
     :maxdepth: 1
     :caption: Examples
 
-    finetuning_example
-    lora_transferlearning_example
-    parameterquantization
-    attentionmodule_example
-    data_processing
+    finetuning_example.md
+    lora_transferlearning_example.md
+    parameterquantization.md
+    attentionmodule_example.md
+    data_processing.md
+
+
+.. bibliography:: references.bib
+   :filter: author % "Zare Chavoshi"
+
+   .. code-block:: bibtex
 
+      @misc{Zare Chavoshi_2023,
+          title={EasyDeL, an open-source library, is specifically designed to enhance and streamline the training process of machine learning models. It focuses primarily on Jax/Flax and aims to provide convenient and effective solutions for training Flax/Jax Models on TPU/GPU for both Serving and Training purposes.},
+          url={https://github.com/erfanzar/EasyDeL},
+          journal={EasyDeL Easy and Fast DeepLearning with JAX},
+          publisher={Erfan Zare Chavoshi},
+          author={Zare Chavoshi, Erfan},
+          year={2023}
+      }
\ No newline at end of file
diff --git a/docs/requirements.txt b/docs/requirements.txt
index e30bf04a8..a8e326f9c 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -24,4 +24,5 @@ accelerate
 sphinx
 sphinx-autobuild
 sphinx-autodoc-typehints
-sphinx-book-theme
\ No newline at end of file
+sphinx-book-theme
+myst-parser
\ No newline at end of file