diff --git a/README.rst b/README.rst
index 4b7ff42a..8600adc7 100644
--- a/README.rst
+++ b/README.rst
@@ -16,6 +16,7 @@ community that make adding new functionality easy.
 .. _Werkzeug: https://werkzeug.palletsprojects.com/
 .. _Jinja: https://jinja.palletsprojects.com/
 
+Flask supports Python 3.8 and newer, but we recommend using the latest version.
 
 Installing
 ----------
@@ -29,8 +30,14 @@ Install and update using `pip`_:
 .. _pip: https://pip.pypa.io/en/stable/getting-started/
 
 
-A Simple Example
-----------------
+Overview
+------------
+
+Flask can be as simple as a single python file with the following pieces:
+
+#. Importing Flask
+#. Configuring the router
+#. Defining a method of returning code, typically HTML. 
 
 .. code-block:: python
 
@@ -43,11 +50,39 @@ A Simple Example
     def hello():
         return "Hello, World!"
 
+This python can be compiled and ran using flash run:
+
 .. code-block:: text
 
     $ flask run
       * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
 
+However, as the project grows, it is recommended to structure your app with packages. An example can be found in our docs: https://flask.palletsprojects.com/en/3.0.x/tutorial/layout/
+
+
+
+Why Flask?
+----------
+
+If you're wondering why use Flask, here are a few benefits it provides:
+
+**Simplicity:** Flask is designed to be simple and easy to use, making it ideal for beginners and experienced developers alike. Its minimalist approach allows developers to focus on building their application logic without getting bogged down by unnecessary complexity.
+
+**Flexibility:** Flask is highly flexible and can be easily customized to fit the specific requirements of your project. You can use only the components you need and integrate third-party extensions as necessary, giving you full control over your application's architecture.
+
+**Lightweight:** As a microframework, Flask has minimal dependencies and a small footprint, making it lightweight and efficient. This results in faster performance and reduced overhead compared to larger frameworks.
+
+**Scalability:** Flask's lightweight and modular architecture make it well-suited for building scalable web applications. You can start small and add features as your application grows, ensuring that it remains efficient and manageable over time.
+
+**Extensibility:** Flask has a rich ecosystem of extensions that provide additional functionality for common tasks such as authentication, database integration, and form validation. These extensions can save you time and effort by providing pre-built solutions for common challenges.
+
+**Community and Documentation:** Flask has a large and active community of developers who contribute to its development and provide support to other users. The official Flask documentation is comprehensive and well-maintained, making it easy to get started and find answers to your questions.
+
+Use-cases:
+----------
+
+With Flask, you can unleash your creativity to build a variety of cool projects. From developing web applications ranging from simple blogs to complex e-commerce platforms, to creating RESTful APIs for mobile apps and IoT devices, Flask offers flexibility and simplicity. You can also dive into real-time web applications like chat apps, craft interactive data visualizations, deploy machine learning models, build microservices architectures, develop interfaces for IoT devices, and even explore blockchain applications. With its lightweight architecture and extensive ecosystem, Flask empowers you to bring your ideas to life with ease and efficiency.
+
 
 Contributing
 ------------