diff --git a/README.md b/README.md
index e69de29..7354011 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,91 @@
+# Montreal Building Data
+
+## Contributors
+Kartikay Sharma (kartikay.sharma@concordia.ca)
+
+Koa Wells (kekoa.wells@concordia.ca)
+
+## Dataset Description
+The following dataset contains the collection of buildings in the geojson format for the city of Montreal. The dataset is created by combining multiple open-source datasets provided from the Canadian federal government and the Montreal city government. The dataset is split into several different files. The first file, _name_ contains the entire dataset for the buildings of Montreal. The remainig files contain the buildings sorted by admistrative boundary/district.
+
+## Data Sources
+1. [Montreal Property Assesment Units](https://donnees.montreal.ca/dataset/unites-evaluation-fonciere)
+2. [Montreal 3D Buildings (LOD2 model with textures)](https://donnees.montreal.ca/dataset/batiment-3d-2016-maquette-citygml-lod2-avec-textures2) 
+3. [Montreal Aerial Lidar Dataset](https://donnees.montreal.ca/dataset/lidar-aerien-2015)
+4. [NRCAN Building Footprints](https://open.canada.ca/data/en/dataset/7a5cda52-c7df-427f-9ced-26f19a8a64d6)
+5. [Administrative boundaries of the agglomeration of Montréal (boroughs and related cities)](https://donnees.montreal.ca/dataset/limites-administratives-agglomeration)
+
+## List of dataset changes
+1. Removed redundant building footprint vertices
+2. Removed duplicate buildings (condominium unit duplicates)
+3. Append building's district - "ADMIN_BOUNDARY"
+4. Append building centroid - "CENTROID"
+5. Remove buildings with 9999 year of construction
+6. 
+7. 
+8. 
+
+## Known issues with dataset
+
+## Dataset Information
+This dataset contains 3d building in multipatch format for 6 teritorries of Montreal city with their respecitve construction year and building use type. 
+The Administrative Boundaries are:
+ 
+1. Anjou: 
+2. Pointe-Claire: 
+3. Rosemont-La Petite-Patrie: 
+4. Kirkland: 
+5. Westmount: 
+6. Hampstead: 
+7. Mercier-Hochelaga-Maisonneuve: 
+8. Senneville: 
+9. Le Sud-Ouest: 
+10. Rivière-des-Prairies-Pointe-aux-Trembles: 
+11. Sainte-Anne-de-Bellevue: 
+12. Le Plateau-Mont-Royal: 
+13. Verdun: 
+14. Dollard-Des Ormeaux: 
+15. Montréal-Est: 
+16. Baie-D'Urfé: 
+17. Lachine: 
+18. Côte-des-Neiges-Notre-Dame-de-Grâce: 
+19. Villeray-Saint-Michel-Parc-Extension: 
+20. L'Île-Dorval: 
+21. Côte-Saint-Luc: 
+22. Beaconsfield: 
+23. Pierrefonds-Roxboro: 
+24. Montréal-Nord: 
+25. Mont-Royal: 
+26. Montréal-Ouest:
+27. Ahuntsic-Cartierville: 
+28. Saint-Léonard: 
+29. Outremont: 
+30. Ville-Marie: 
+31. L'Île-Bizard-Sainte-Geneviève: 
+32. Dorval: 
+33. Saint-Laurent: 
+34. LaSalle: 
+
+Côte-des-Neiges–Notre-Dame-de-Grâce: 20100 buildings 
+Outremont:3529 buildings 
+Le Plateau-Mont-Royal:14326 buildings 
+Le Sud-Ouest: 9926 buildings 
+Verdun: 9001 buildings 
+Ville-Marie: 8371 buildings
+
+
+## Meta data
+1. "ID_UEV": unique building identifier
+2. "ANNEE_CONS": year of construction
+3. "CODE_UTILI": building usage type
+4. "CENTROID": longitude, latitude of building centroid
+5. "ADMIN_BOUNDARY": adminstrative boundary the building belongs to
+
+**********************************
+Alert/Caution (Mandatory)
+**********************************
+Do's & Dont' of the dataset
+
+ 
+
+Any inherent problem associated with the data, etc...
\ No newline at end of file