updated README.md

Author: albertoabellagarcia

README.md

@@ -1,2 +1,42 @@
 # dataModel.OpenStreetMap
-DAta models mapped from the objects defined in the OpenStreeMap https://www.openstreetmap.org
+
+
+
+### List of data models
+
+The following entity types are available:
+- [OSMAerialway](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMAerialway/README.md). An aerial transport or lift from OpenStreetMap tagged with aerialway=*. Describes cable cars, gondolas, chair lifts, and drag lifts
+
+- [OSMAmenity](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMAmenity/README.md). A facility or amenity from OpenStreetMap tagged with amenity=*. Represents places of public or private use such as restaurants, schools, hospitals, banks, etc
+
+- [OSMBuilding](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMBuilding/README.md). A building or group of connected buildings from OpenStreetMap tagged with building=*. Represents the physical structure of a building, including its geometry, dimensions, materials, and functional classification. For specific functions within a building (shop, amenity, etc.) additional entities should be used.
+
+- [OSMBuildingPart](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMBuildingPart/README.md). A part or section of a building from OpenStreetMap tagged with building:part=*. Used to represent buildings with varying heights, roof shapes, or materials across different sections, enabling 3D building visualisation (Simple 3D Buildings standard).
+
+- [OSMCycleRoute](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMCycleRoute/README.md). A dedicated cycling infrastructure element from OpenStreetMap. Represents cycle paths, shared cycle lanes, and bike routes tagged with highway=cycleway or cycleway=* on road ways.
+
+- [OSMHighway](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMHighway/README.md). A road or path element from OpenStreetMap tagged with the highway key. Represents all types of roads, from motorways to footpaths, as defined by the OSM highway taxonomy.
+
+- [OSMLanduse](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMLanduse/README.md). An area of land use from OpenStreetMap tagged with landuse=*. Describes the primary human purpose or use of an area of land
+
+- [OSMLeisure](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMLeisure/README.md). A place for leisure, sports, or recreation from OpenStreetMap tagged with leisure=*. Includes parks, sports pitches, swimming pools, stadiums, etc
+
+- [OSMNatural](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMNatural/README.md). A natural feature from OpenStreetMap tagged with natural=*. Describes geographical features such as water bodies, woods, scrub, peaks, beaches, etc
+
+- [OSMParkingArea](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMParkingArea/README.md). A vehicle parking area or facility from OpenStreetMap tagged with amenity=parking. Represents surface car parks, multi-storey garages, underground facilities, and other organised parking areas.
+
+- [OSMPublicTransportStop](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMPublicTransportStop/README.md). A public transport stop, station, platform or boarding point from OpenStreetMap. Represents nodes and areas where passengers board or alight from public transport services, tagged with public_transport=* or specific mode tags.
+
+- [OSMRailway](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMRailway/README.md). A railway track or infrastructure element from OpenStreetMap tagged with the railway key. Covers all types of rail infrastructure, from mainline heavy rail to trams, subways and funiculars.
+
+- [OSMShop](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMShop/README.md). A shop or retail store from OpenStreetMap tagged with shop=*. Represents establishments selling retail products directly to end customers
+
+- [OSMTourism](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMTourism/README.md). A tourist attraction or tourism-related facility from OpenStreetMap tagged with tourism=*. Includes hotels, museums, viewpoints, artworks, etc
+
+- [OSMWaterway](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/OSMWaterway/README.md). A waterway from OpenStreetMap tagged with waterway=*. Describes rivers, streams, canals, drains, and other water courses
+
+### Contributors
+[Link](https://github.com/smart-data-models/dataModel.OpenStreetMap/blob/master/CONTRIBUTORS.yaml) to the 1 current contributors.
+
+### Contribution
+You can raise an [issue](https://github.com/smart-data-models/dataModel.OpenStreetMap/issues) or submit your [PR](https://github.com/smart-data-models/dataModel.OpenStreetMap/pulls) on existing data models.