docs: update readme

Author: sinedied

HOW_TO_USE.md

@@ -2,7 +2,7 @@
 
 ## 📚 Browse the content
 
-The easiest way to browse the available content is to visit the [website](https://aka.ms/moaw).
+The easiest way to browse the available content on the [website](https://aka.ms/moaw/catalog).
 
 ## 👩‍🏫 Conduct a workshop
 

README.md

@@ -1,59 +1,45 @@
 # 🌳 The Mother Of All Workshops (MOAW)
 
-[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA-black.svg)](https://creativecommons.org/licenses/by-sa/4.0/)
-[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://github.dev/microsoft/moaw)
+[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20VS%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://github.dev/microsoft/moaw)
 [![Deploy website to GitHub Pages](https://github.com/microsoft/moaw/actions/workflows/deploy.yml/badge.svg)](https://github.com/microsoft/moaw/actions/workflows/deploy.yml)
+[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA-222.svg)](https://creativecommons.org/licenses/by-sa/4.0/)
 
-https://aka.ms/moaw
+Grab-and-go resources to help you learn new skills, with all the tools you need to create, host and share your own workshop.
 
-This repository contains workshop content about Microsoft technologies.
-
-**The goal is to provide a common repository to facilitate reuse, translations, adaptations and sharing of this content. We also provide convenient tools for consuming and delivering this content.**
+👉 https://aka.ms/moaw
 
 <div align="center">
   <img src="https://user-images.githubusercontent.com/593151/185623023-1175ab1f-9f55-461c-884f-9ed9723edaf3.jpg" alt="logo" />
 </div>
 
-All the content is available under the [Creative Commons Attribution-ShareAlike 4.0 International License](#license), meaning that share and modify it any way you want, as long as you credit the original authors and keep the modified content under the same license.
-
-# Usage
-
-## 📚 Browse the content
-
-The easiest way to browse the available content is to look at the [website](https://aka.ms/moaw/catalog).
-
-## 👩‍🏫 Conduct a workshop
+## Usage
 
-You can link to any workshop from this repository using the following URL format: `https://aka.ms/ws?src=<workshop_folder>/`
+### 📚 Want to learn something new?
 
-**Example:** [https://aka.ms/ws?src=swa-gatsby-portfolio/](https://aka.ms/ws?src=swa-gatsby-portfolio/)
+Browse the available content on the [website](https://aka.ms/moaw/catalog).
 
+### 👩‍🏫 Want to conduct a workshop?
 
-#### Additional tips
+You can link to any workshop from this repository using the following URL format:
+`https://aka.ms/ws?src=<workshop_folder>/`
 
-- You can also link to any workshop in a publicly available GitHub repository using: `https://aka.ms/ws?src=gh:<github_repo/path_to_file>`<br>
-  This way you can adapt the content as you need in your fork and use it directly.
+**Example:** [https://aka.ms/ws?src=create-workshop/](https://aka.ms/ws?src=create-workshop/)
 
-- You can link to a specific section of a workshop, by adding a `step` parameter and an anchor link to the URL: `&step=<section_index>#<heading_id>`
+For more details, see the [HOW_TO_USE](HOW_TO_USE.md#-conduct-a-workshop) guide.
 
-- You can share any individual markdown-formatted page, using the URL format: `https://aka.ms/ws/page?src=<workshop_folder/path_to_file>` or `https://aka.ms/ws/page?src=gh:<github_repo/path_to_file>`<br>
-This is useful for sharing prerequisites, notes, etc.
+### 🚀 Want to create a new workshop?
 
-## 📝 Adapt and modify content
+Follow this step-by-step tutorial for detailed instructions: [Create a workshop](https://microsoft.github.io/moaw/workshop/create-workshop/).
 
-You're free to adapt, modify and localize the content of this repository to better fit your needs, as long as you keep the [license](#LICENSE) and credit the original authors.
-
-The easiest way to do that is to fork this repository and make your changes in your fork. You can then link to your fork using the URL format described above.
-
-If you made changes that you think would be useful to others, please also consider opening a pull request to [contribute](CONTRIBUTING.md) to this repository.
-
-# Contributing
+## Contributing
 
 All contributions are welcome, including translations, new workshops, bug fixes, etc.
 If you want to contribute to this repository, please read the [contributing guidelines](CONTRIBUTING.md).
 
-# License
+## License
 
 [![Creative Commons License](https://i.creativecommons.org/l/by-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-sa/4.0/)
 
-This work is licensed under a [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/").
+All workshop content is available under the [Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/), meaning that you can share and modify it any way you want, as long as you credit the original authors and keep the modified content under the same license.
+
+The source code of the various tools is available under the [MIT License](packages/website/LICENSE).