diff --git a/README.md b/README.md
index a8af6b53..488f388b 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,19 @@
 # libs
 
-Libs is a generic repository containing the following classes
+Libs is part of Insel4D architecture for the urban simulations, created by the CERC group at Concordia University.
+
+Libs repository contains a set of classes modeling the data for urban environments in the form of:
 
 * city_model_structure
 * geometry
 * physics
-* usage
\ No newline at end of file
+* usages
+
+Released under [LGPL license](LICENSE.md), will provide an object-oriented, modular approach to urban simulations.
+
+Our aims are: 
+
+* involve as many scientists and contributors as possible
+* provide a complete set of classes that help scientists and students to model urban environments.
+
+Please check the [contributing information](CONTRIBUTING.md) and [code of conduct](CODE_OF_CONDUCT.md) if you want to contribute, and let us know any new feature you may be of interest for you or your team.
\ No newline at end of file