chore(readme)

Author: Laegel

README.md

@@ -1,18 +1,23 @@
 # Tauri Docs
 
-This website is built using [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator.
+This website is built using [Docusaurus 2](https://v2.docusaurus.io/) with [MeiliSearch](https://github.com/meilisearch/) for the docs indexation and is deployed by Netlify.
 
 [![Deploys By Netlify](https://www.netlify.com/img/global/badges/netlify-light.svg)](https://www.netlify.com)
 
-You can check the state of a PR by looking at the Deploy preview that Netlify builds and is mentioned in its bot's comment.
+If you seek to change something from **our guides**, please refer to [the docs folder from the Core repository](https://github.com/tauri-apps/tauri/tree/dev/docs).
 
-### Installation
+The **API docs** are generated from our [Rust](https://github.com/tauri-apps/tauri/tree/dev/core/tauri) and [TypeScript](https://github.com/tauri-apps/tauri/tree/dev/tooling/api) source code.
+
+In the end, as the guides and the API live in the Core repository, tauri-docs just holds the components and various pages that don't need to follow the Core repository version; this way, we don't pollute the Core repository with commits, PRs or issues related to the website only.
+
+
+## Installation
 
 ```
 $ yarn
 ```
 
-### Local Development
+## Local Development
 
 ```
 $ yarn start
@@ -22,7 +27,7 @@ This command starts a local development server and open up a browser window. Mos
 
 Note that only English language is supported during development phase in order to keep a small build time.
 
-### Build
+## Build
 
 ```
 $ LANGUAGE=${language} yarn build --out-dir ./build/${language}
@@ -40,17 +45,23 @@ supported-languages.js is the module containing the enabled/targeted languages f
 
 Uncomment a language when at least "Getting started" and most of "Usage" docs are translated.
 
-### Deployment
+## Deployment
 
 ```
 $ GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy
 ```
 
 If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
 
-### Contributing
+## Contributing
+
+### Writing/fixing docs
+
+Feel free to open an issue/a PR if you find something weird in the docs.
+
+Your PR once submitted to us, will automatically deploy to a temporary Netlify instance for us or you to review through GitHub's CI/CD checks: you will be able to click on a preview link once the build is ready.
 
-Feel free to open an issue/a PR if you find something weird in the docs, your feedback is more than welcome!
+### Internationalization (i18n)
 
 We're working with Crowdin to manage translations, if you feel like you want to lend a hand for translations, take a look at the documentation project: https://tauri.crowdin.com/documentation