diff --git a/README.md b/README.md index 4cd4677..a734ca9 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,27 @@ directly or programmatically. | :books:
[NGSI-LD
Documentation](https://ngsi-ld-tutorials.rtfd.io/) |
[Postman
Collections](https://explore.postman.com/team/3mM5EY6ChBYp9D) | [![Docker Hub](https://nexus.lab.fiware.org/repository/raw/public/badges/docker/fiware.svg)](https://hub.docker.com/u/fiware)
[![Quay.io](https://img.shields.io/badge/quay.io-fiware-grey?logo=red%20hat&labelColor=EE0000)](https://quay.io/organization/fiware)
[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/fiware)](https://artifacthub.io/packages/search?repo=fiware) |
[**developer.​fiware.org**](https://www.fiware.org/developers/) | | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +
+ +> [!NOTE] +> **Should I use NGSI-LD or NGSI-v2?** +> +> FIWARE offers two flavours of the NGSI interfaces: +> +> +> - **NGSI-v2** offers JSON based interoperability used in individual Smart Systems +> - **NGSI-LD** offers JSON-LD based interoperability used for Federations and Data Spaces +> +> Of the two, NGSI-LD is more complex and relies on the introduction of a JSON-LD `@context`. +> A full understanding of JSON-LD (Linked Data) is required to obtain the benefits of NGSI-LD , +> which allows for interoperability across apps and organisations. +> +> In general, you should use NGSI-LD when creating a data space or introducing a system of systems aproach. +> +> Use NGSI-v2 for simpler isolated systems. More information about NGSI-v2 can be found [here](https://fiware-tutorials.readthedocs.io) + + +

Data models

The tutorials define a series of data-models to be used within the `@context`. More information about the classes and