diff --git a/README.md b/README.md
index 3cc972042..8611c76c5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,42 @@
-This repository will hold TIP WiFi specific scripts and glue
-logic.  It will utilize the scripts in wlan-lanforge-scripts and possibly
-other Cloud-SDK libraries in the future.
+## TIP Open WiFi Testing
+This repository contains the test automation framework and scripts for  TIP Open WiFi.
 
+## Motivation
+Automate Automate and Automate!
 
+## Build status
+*WIP*  
+[![Build Status](https://github.com/Telecominfraproject/wlan-testing/workflows/nightly%20build/badge.svg)]
+
+## Code style
+All code must be written in python 3 and conform to PEP 8 style guide. The test framework is built using pytest.  
+[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)   
+[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)  
+
+## Proposed Directory Structure
+```bash
+├── pytest
+│   ├── helpers
+│   │   ├── *.py      /* AP, SDK, LANForge, Perfecto libs */
+│   ├── Dockerfile
+│   ├── pytest.ini
+│   ├── conftest.py
+│   ├── *.py  (test cases)
+├── CICD_AP_CLOUSDK - /* to be deleted */
+├── cicd            - /* to be deleted */
+├── docker          - /* to be deleted */
+├── lanforge        - /* under cleanup consideration */
+├── testbeds        - /* under cleanup consideration */
+├── unit_tests      - /* to be deleted */
+```
+
+## TO DO
+- [x] Pytest proof of concept
+- [ ] Pytest documentation
+- [x] Dockerized test framework PoC
+- [x] Github nightly trigger - PoC
+- [ ] Deprecate uni_tests script and move methods into pytest Directory
+- [ ] Move Java Selenium to python/Selenium
+- [ ] Deprecate cicd scripts and move to Pytest
+- [ ] lanforge needs to be ingested as python module
+- [ ] testbeds cleanup based on Lab Orchestration