updated README

plugins/basic-block-translations-3df23d/README.md

@@ -7,45 +7,21 @@
 | [📁](https://github.com/WordPress/block-development-examples/tree/trunk/plugins/basic-block-translations-3df23d) | Basic Block with Translations                                             | <small><code><a href="https://github.com/WordPress/block-development-examples/wiki/03-Tags#static-rendering">STATIC RENDERING</a></code></small> | `3df23d`                                                                                                                                     | [📦](https://raw.githubusercontent.com/WordPress/block-development-examples/deploy/zips/basic-block-translations-3df23d.zip "Install the plugin using this zip and activate it. Then use the ID of the block (3df23d) to find it and add it to a post to see it in action") | [![](https://raw.githubusercontent.com/WordPress/block-development-examples/trunk/assets/icon-wp.svg)](https://playground.wordpress.net/#%7B%22landingPage%22:%22/wp-admin/plugins.php%22,%22steps%22:%5B%7B%22step%22:%22login%22,%22username%22:%22admin%22,%22password%22:%22password%22%7D,%7B%22step%22:%22mkdir%22,%22path%22:%22/downloads%22%7D,%7B%22step%22:%22writeFile%22,%22path%22:%22/downloads/plugin.zip%22,%22data%22:%7B%22resource%22:%22url%22,%22url%22:%22https://raw.githubusercontent.com/WordPress/block-development-examples/deploy/zips/basic-block-translations-3df23d.zip%22,%22caption%22:%22Downloading%20plugin...%22%7D%7D,%7B%22step%22:%22installPlugin%22,%22pluginZipFile%22:%7B%22resource%22:%22vfs%22,%22path%22:%22/downloads/plugin.zip%22%7D%7D%5D%7D "Use the ID of the block (3df23d) to find it and add it to a post to see it in action") |
 <!-- @TABLE EXAMPLES END -->
 
-Basic block that shows how to use translations in a block.
-
-## Start Guide
-
-The examples in this repo require these three steps to see them in action:
-
-1. Install dependencies
-2. Generate the build
-3. Use it in a WordPress installation
-
-The way to manage the first two steps will be different depending on the context you're using this example.
+The goal of this example is to showcase how to use translations in a block.
 
 > **Note**
-> At the [WIKI of this repo](https://github.com/WordPress/block-development-examples/wiki) you have the documentation for the examples on this repo
-
-
-### As an example inside this monorepo
-
-The quickest way to have access to all the examples is clone this repository and check out the examples locally.
-
-Check the [05 Development > Repo Commands > Dependencies](https://github.com/WordPress/block-development-examples/wiki/05-Development#dependencies) instructions for this repo to install the dependencies of this example.
-
-Once the depencies are installed (a `node_modules` folder should have been created), [launch the build process](https://github.com/WordPress/block-development-examples/wiki/05-Development#build-process) to get the final version of the block that can be used in WordPress. 
-
-Check the [WordPress Local Development Environment](https://github.com/WordPress/block-development-examples/wiki/05-Development#wordpress-local-development-environment) to learn how to quickly get your local WordPress installation to see this example.
-
-### As an isolated example on your own WordPress installation
-
-If you have a local WordPress installation already running, you can also put the plugin folders of the examples you're interested in (by copying and pasting, from the zips...) inside the `plugins` folder of that installation and check the examples there.
-
-If you do that, you'll need to do the following
+> Check the [Start Guide for local development with the examples](https://github.com/WordPress/block-development-examples/wiki/02-Examples#start-guide-for-local-development-with-the-examples)
 
-- Remove any `node_modules` folder inside this folder
-- Run `npm install` to install the dependencies
-- Run `npm build` to generate the "build" version of the blocks
-- Activate the plugin in your own WordPress installation
+## Understanding the Example Code
 
-At this point you should be able to insert the custom blocks into any post (after activating the plugin) of your WordPress installation, and see how it behaves in the frontend when published.
+Both the `edit.js` and `save.js` files import the `__` function `@wordpress/i18n` to apply translations to the texts used in the code. 
+- The [`__` function](https://developer.wordpress.org/reference/functions/__/) receives the text and a namespace as parameters
+- At `index.php` we tell WordPress our JavaScript contains translations, using the `wp_set_script_translations()` function.
+- At `languages/` folder there are all the translations files (the source files and the `.mo` ones actually used to apply the translations) 
 
-You can also run `npm start` from this folder to generate a development mode "build" version everytime a change in the code is detected (saved) inside this folder.
+## Related resources
 
+- [Internationalization](https://developer.wordpress.org/block-editor/how-to-guides/internationalization/)
+- [`__()`](https://developer.wordpress.org/reference/functions/__/)
+- [`wp_set_script_translations()`](https://developer.wordpress.org/reference/functions/wp_set_script_translations/)