Apply suggestions from code review

Co-authored-by: Anna Krystalli <[email protected]>

README.Rmd

@@ -26,7 +26,7 @@ options(timeout = 2000)
 
 The goal of emodnet.wfs is to allow interrogation of and access to [EMODnet's, European Marine Observation and Data Network, geographic vector data](https://emodnet.ec.europa.eu/en/emodnet-web-service-documentation#inline-nav-3) in R through the [EMODnet Web Feature Services](https://emodnet.ec.europa.eu/en/data-0). 
 [Web Feature services (WFS)](https://www.ogc.org/publications/standard/wfs/) represent a change in the way geographic information is created, modified and exchanged on the Internet and offer direct fine-grained access to geographic information at the feature and feature property level. 
-Features are _observations_ and feature properties are _variables_.
+Features are representation of geographic entities, such as a coastlines, marine protected areas, offshore platforms, or fishing areas. In WFS, features have geometry (spatial information) and attributes (descriptive data).
 emodnet.wfs aims at offering an user-friendly interface to this rich data.
 
 ## Installation and setup
@@ -71,7 +71,9 @@ services$service_name
 
 To explore available services you can use `View()` or your usual way to explore `data.frames`.
 
-## Connect to a data source: Create a service client
+## Initialise a WFS Service Client
+
+A WFS service client is responsible for sending requests to a WFS server and processing the responses to retrieve, display, or analyze geospatial features. As such, initialising a client is the first step to interacting with an EMODnet Web Feature Services.
 
 Specify the service using the `service` argument. 
 
@@ -81,9 +83,11 @@ wfs_bio <- emodnet_init_wfs_client(service = "biology")
 wfs_bio
 ```
 
-## List contents of a data source: Get layer information from a service client
+## List contents of a WFS: Get layer information from a service client
+
+In the context of a Web Feature Service (WFS), a layer refers to a logical grouping of geographic features that share the same schema (i.e., the same feature type, geometry, and attributes). Layers are the units of data that clients can query, retrieve, and manipulate through a WFS.
 
-You can get metadata about the datasets, called layers, available from a service. 
+You can access information (metadata) about each layer available from an EMODnet WFS with `emodnet_get_wfs_info()`
 
 ```{r}
 emodnet_get_wfs_info(service = "biology")
@@ -124,7 +128,7 @@ By default, `emodnet_get_layers()` returns a list of sf objects, one per layer.
 emodnet_get_layers(wfs = wfs_bio, layers = layers)
 ```
 
-You can change the output `crs` ("projection") through the argument `crs`.
+You can change the output Coordinate Reference System (CRS), which defines how geographic data is mapped to the Earth's surface,  through the argument `crs`.
 
 ```{r}
 emodnet_get_layers(wfs = wfs_bio, layers = layers, crs = 3857)