update articles

Author: MichaelKreil

playground/simple-map/text.md

@@ -11,8 +11,8 @@ description: How to add a simple OSM map.
 In our example, we load these assets from our demo server at `https://tiles.versatiles.org`, but you can modify all URLs as needed.
 
 > [!WARNING]
-> You might want to include libraries such as MapLibre GL JS directly in your project and serve them yourself instead of loading them from tiles.versatiles.org. We regularly update front-end libraries on our demo server. However, this could introduce breaking changes to your project at some point in the future.
+> You might want to include libraries such as MapLibre GL JS directly in your project and serve them yourself instead of loading them from tiles.versatiles.org. We regularly update frontend libraries on our demo server. However, this could introduce breaking changes to your project at some point in the future.
 
-Loading the MapLibre libraries adds the global `maplibregl` variable to the JavaScript environment. Use `new maplibregl.Map()` to initialise your map.
+Loading the MapLibre library adds the global `maplibregl` variable to the JavaScript environment. Use `new maplibregl.Map()` to initialise your map.
 
-To learn more about all the options provided by MapLibre, take a look at the documentation for the [Map class documentation](https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/) and in general the [MapLibre API documentation](https://maplibre.org/maplibre-gl-js/docs/API/).
+To learn more about all the options provided by MapLibre, take a look at the documentation for the [Map class documentation](https://maplibre.org/maplibre-gl-js/docs/API/classes/Map/) and in general the [MapLibre API documentation](https://maplibre.org/maplibre-gl-js/docs/API/). We can also highly recommend all the [MapLibre examples](https://maplibre.org/maplibre-gl-js/docs/examples/).

playground/simple-style/text.md

@@ -3,7 +3,9 @@ title: Simple Style
 description: How to style a simple OSM map.
 ---
 
-[MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) use styles to define your map. These styles are quite complex JavaScript objects that define data sources, layers, colors, fonts, symbols, etc. (If you later want to really fine tune your map you can find the complete specification here: [MapLibre Style Spec](https://maplibre.org/maplibre-style-spec/)) To make it easier to work with map styles, we've developed a [JavaScript library "versatiles-style"](https://github.com/versatiles-org/versatiles-style) to generate styles very fast and efficient in the frontend or the backend.
+[MapLibre GL JS](https://maplibre.org/maplibre-gl-js/docs/) use special `style` objects that define the appearance of your map. These `style` object are quite complex JavaScript objects that define data sources, layers, colors, fonts, symbols, etc. (If you later want to really fine tune your map you can find the complete specification here: [MapLibre Style Spec](https://maplibre.org/maplibre-style-spec/))
+
+To make it easier to work with these map styles, we've developed the [JavaScript library "versatiles-style"](https://github.com/versatiles-org/versatiles-style) to generate styles very fast and efficient in the frontend or the backend.
 
 Based on our [frontend specification](https://docs.versatiles.org/compendium/specification_frontend.html), the library should be ready to use under:
 
@@ -12,21 +14,22 @@ Based on our [frontend specification](https://docs.versatiles.org/compendium/spe
 Loading our library adds the global variable `VersaTilesStyle` to the JavaScript environment. To generate a style ready to use simply run:
 
 ```javascript
-const style = VersaTilesStyle.colorful();
+const style = VersaTilesStyle.colorful(); // <- generates a style
+
 new maplibregl.Map({
-	style // <- use the generated style
+	style // <- use the style
 	container: "map",
 })
 ```
 
 We also provide other functions to generate base styles, like `colorful`, `eclipse`, `graybeard` and `neutrino`.
 
-All these style functions accept optional properties to adapt the styles, like:
+All these style functions accept optional properties to fine tune the styles, like:
 
 ```javascript
 {
-   baseUrl: string; // host of the map server, like "https://example.org"
-   bounds: [number, number, number, number]; // bbox of the initial view
+   baseUrl: string; // host of your map server, like "https://example.org"
+   bounds: [number, number, number, number]; // bounding box of the initial view
    colors: Partial<StyleBuilderColors>; // to change individual colors
    fonts: Partial<StyleBuilderFonts>; // to change the default fonts
    glyphs: string; // to change the url template of the fonts
@@ -38,7 +41,7 @@ All these style functions accept optional properties to adapt the styles, like:
 }
 ```
 
-So for example, the following code will generate a style without labels and tint it green to make it look like "Matrix" so people from the 90's will think your map looks cool.
+For example, the following code will generate a map style without labels and tint it green, making it look like the 'Matrix', which will make people from the '90s think your map looks cool.
 
 ```javascript
 const style = VersaTilesStyle.colorful({
@@ -58,7 +61,7 @@ To learn more about all the options provided by "versatiles-style", take a look
 - [StyleBuilderColors](https://versatiles.org/versatiles-style/interfaces/StyleBuilderColors.html) for the property `colors` to change individual colors.
 
 > [!NOTE]\
-> ["versatiles-style"](https://github.com/versatiles-org/versatiles-style) helped us a lot to make it easier to work with map styles. That is way we plan to completely revamp the whole library in 2025.
+> ["versatiles-style"](https://github.com/versatiles-org/versatiles-style) helped us a lot in making it easier to work with map styles. However, many features are missing. That is why we plan to completely revamp the entire library in 2025.
 
 > [!WARNING]
-> You might want to include libraries directly in your project and serve them yourself instead of loading them from tiles.versatiles.org. We regularly update front-end libraries on our demo server. However, this could introduce breaking changes to your project at some point in the future.
+> Instead of loading the libraries from tiles.versatiles.org, we recommend including them directly in your project and hosting them yourself. Since we regularly update the front-end libraries on our demo server, future updates may affect your project.