diff --git a/readme.txt b/readme.txt
index d674727..a371e36 100644
--- a/readme.txt
+++ b/readme.txt
@@ -1,2 +1,26 @@
-Los poductos que ya expiraron o se han agotado no se muestran y en caso de que se muestren no pueden ser comprados, estos cambios solo fueron aplicados a el indice(index)
-, a la busqueda(search) y a los articulos por categorias(categories)
\ No newline at end of file
+### Project Overview
+
+This project is focused on managing product availability and ensuring that expired or out-of-stock items are not displayed or available for purchase. The implementation of these functionalities affects the following areas:
+
+1. **Index**: The homepage where products are initially displayed.
+2. **Search**: The search functionality used to find products.
+3. **Categories**: The display of products sorted by categories.
+
+### Key Features
+- **Product Availability**: Products that have expired or are out-of-stock will not be shown.
+- **Purchase Restriction**: Items that are displayed but are unavailable cannot be purchased.
+
+### Setup Instructions
+1. **Clone the Repository**: Use `git clone` to get a copy of the project.
+2. **Environment Setup**: Ensure you have PHP 5.3 or higher installed.
+3. **Run the Project**: Place the project in your server's root directory and start the server.
+
+### Best Practices
+- Follow the [code_style] conventions.
+- Ensure any changes conform to existing patterns and naming conventions.
+
+### Contributing
+- Please submit issues and pull requests for any improvements or fixes.
+
+### Contact
+- For any queries or issues, feel free to reach out to the project maintainers.
\ No newline at end of file