Review:

- Fix typos
- Add more examples

Author: Pasquale Latrofa

content/en/docs/apidocs-mxsdk/apidocs/studio-pro/extensibility-api/web/web-extensions-howtos/model-api.md

@@ -18,7 +18,7 @@ This how-to provides guidance on using the Model Access API:
 The Model Access API allow access to the Mendix model.
 
 The model is split in several components exposed via `studioPro.app.model` object. Currently supported components are:
-* BuildinBlocks
+* BuildingBlocks
 * DomainModels
 * Enumerations
 * Pages
@@ -32,52 +32,62 @@ const { pages, domainModels } = studioPro.app.model;
 
 An element is part of a Mendix model and all elements together form the logic of the model. Elements may contain other elements. An element always has a container element, which is its parent. The root of an element tree is always a unit.
 
-Each component exposes the units info of the units it is responsible for. The full unit content can be accessed only after loading the unit.
+Each component (e.g. `studioPro.app.model.pages` and `studioPro.app.model.domainModels`) exposes the units info of the units it is responsible for. The full unit content can be accessed only after loading the unit.
 
-The unit info contains the the following fields:
-| Name | Description | 
-| --- | --- |
-| `$ID` | The unique id of the unit |
-| `$Type` | The type of the unit |
-| `moduleName` | (Optional) The name of the module containing the unit |
-| `name` | (Optional) The name of the unit |
+The unit info, described by the `UnitInfo` interface, contains the the following fields:
+| Name | Description | Example value |
+| --- | --- | --- |
+| `$ID` | The unique id of the unit | `077d1338-a548-49a9-baee-c291e93d19af` |
+| `$Type` | The type of the unit | `Pages$Page` |
+| `moduleName` | (Optional) The name of the module containing the unit | `MyFirstModule` | 
+| `name` | (Optional) The name of the unit | `ExamplePage` |
 
 All the units managed by the DomainModels component can be retrieved by:
 
 ```ts
-const unitsInfo = await domainModels.getUnitsInfo()
+const unitsInfo: Primitives.UnitInfo[] = await domainModels.getUnitsInfo()
 ```
 
-Units can be loaded by suppling a function to `loadAll` to execute for each unit. It should return a truthy value to load the unit.
+Units can be loaded by supplying a function to `component.loadAll(fn)` to execute for each unit. The function `fn` should return a truthy value to load the specified unit.
 
 The followind snippet loads the DomainModel for the module named `MyFirstModule`:
 
 {{% alert color="warning" %}}
-Loading units is an expensive process. Only load the minimun number of units you need when you need them.
+Loading units is a resource intensive process. Only load the minimum number of units you need when you need them.
 {{% /alert %}}
 
 ```ts
-const [domainModel] = await domainModels.loadAll((info) => info.moduleName === 'MyFirstModule');
+const [domainModel] = await domainModels.loadAll((info: Primitives.UnitInfo) => info.moduleName === 'MyFirstModule');
 ```
+The followind snippet loads the Page named `Home_Web` inside the module named `MyFirstModule`:
 
+```ts
+const [page] = await pages.loadAll((info: Primitives.UnitInfo) => info.moduleName === 'MyFirstModule' && info.name === 'Home_Web')
+```
 ## Reading the unit content {#read}
 
-Elements contained inside units can be accessed using the `get<ElementName>` helper methods:
+Elements contained inside units can be accessed using the `get<ElementName>` helper methods.
 
 The following snippet will get the Entity named `MyEntity` from the previously loaded DomainModel unit:
 
 ```ts
-const entity = domainModel.getEntity("MyEntity");
+const entity: DomainModels.Entity = domainModel.getEntity("MyEntity");
 ```
 
 ## Modifying the unit content {#modify}
 
-The Mendix model can be modified by leveraing the `add<ElementName>` helper methods:
+The Mendix model can be modified by leveraging the `add<ElementName>` helper methods.
 
 The following snippet will create a new Entity inside the previously loaded DomainModel unit:
 
+{{% alert color="warning" %}}
+Do not forget to invoke the `component.save(unit)` method after making changes to your unit. The method must be invoked for each modified unit, so changes on multiple units need to be saved separetely.
+{{% /alert %}}
+
 ```ts
-const newEntity = await domainModel.addEntity({ name: "NewEntity", attributes: [{ name: "MyAttribute", type: "AutoNumber" }]})
+const newEntity: DomainModels.Entity = await domainModel.addEntity({ name: "NewEntity", attributes: [{ name: "MyAttribute", type: "AutoNumber" }]});
+
+newEntity.documentation = "New documentation";
 
 await domainModels.save(domainModel);
 ```