feat: rework guides to improve onboarding

blog/2023-03-28-build-a-web3-app-with-react-js.md

@@ -40,7 +40,7 @@ Let’s build our first dapp! In this example, we will create a simple note-taki
 
 ### Initialization
 
-Before you can integrate Juno into your ReactJS app, you’ll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/add-juno-to-an-app/create-a-satellite).
+Before you can integrate Juno into your ReactJS app, you’ll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/create-a-satellite).
 
 Moreover, you also need to install the SDK.
 

blog/2023-04-21-develop-an-angular-app-on-blockchain.md

@@ -40,7 +40,7 @@ Let’s start building our first decentralized application, or “dapp” for sh
 
 ### Initialization
 
-Before you can integrate Juno into your Angular app, you’ll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/add-juno-to-an-app/create-a-satellite).
+Before you can integrate Juno into your Angular app, you’ll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/create-a-satellite).
 
 Moreover, you also need to install the SDK.
 

blog/2023-05-24-build-a-web3-app-with-vuejs.md

@@ -52,7 +52,7 @@ This tutorial and code sample utilize the Vue Composition API.
 
 ### Initialization
 
-Before you can integrate Juno into your app, you'll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/add-juno-to-an-app/create-a-satellite).
+Before you can integrate Juno into your app, you'll need to create a satellite. This process is explained in detail in the [documentation](https://juno.build/docs/create-a-satellite).
 
 Moreover, you also need to install the SDK.
 

blog/2024-02-09-unleashing-the-infinite-with-serverless/index.md

@@ -46,7 +46,7 @@ In addition to unveiling this new feature, we're also excited to introduce a bra
 
 :::note
 
-Make sure you have Juno's [CLI](/docs/miscellaneous/cli#installation) tool installed on your machine.
+Make sure you have Juno's [CLI](/docs/miscellaneous/cli#installing-the-juno-cli) tool installed on your machine.
 
 :::
 

blog/2024-05-20-how-to-redirect-a-route-after-renaming-it.md

@@ -64,7 +64,7 @@ Deploy your updated website using GitHub Actions or by running the `juno deploy`
 
 Next, configure the redirection in your Juno configuration. This involves specifying the old route and the new route so that requests to the old route are redirected to the new one.
 
-For example, we recently renamed [https://juno.build/docs/add-juno-to-an-app/install-the-sdk-and-initialize-juno](https://juno.build/docs/add-juno-to-an-app/install-the-sdk-and-initialize-juno) to [https://juno.build/docs/add-juno-to-an-app/setup](https://juno.build/docs/add-juno-to-an-app/setup). Therefore, we added the following redirection in our [juno.config.ts](https://github.com/junobuild/docs/blob/main/juno.config.ts) file:
+For example, we recently renamed [https://juno.build/docs/install-the-sdk-and-initialize-juno](https://juno.build/docs/install-the-sdk-and-initialize-juno) to [https://juno.build/docs/setup](https://juno.build/docs/setup). Therefore, we added the following redirection in our [juno.config.ts](https://github.com/junobuild/docs/blob/main/juno.config.ts) file:
 
 ```typescript
 import { defineConfig } from "@junobuild/config";

docs/build/authentication.md

@@ -23,7 +23,7 @@ You can manage your users in the [authentication](https://console.juno.build/auh
 
 :::note
 
-The Juno SDK must be [installed](../add-juno-to-an-app/setup) and initialized in your app to use the authentication features.
+The Juno SDK must be [installed](../setup-the-sdk) and initialized in your app to use the authentication features.
 
 :::
 

docs/build/datastore.md

@@ -10,7 +10,7 @@ The Juno Datastore offers a simple key-value model, organized by collections con
 
 :::note
 
-To use these features, the Juno SDK must be [installed](../add-juno-to-an-app/setup) and initialized in your app.
+To use these features, the Juno SDK must be [installed](../setup-the-sdk) and initialized in your app.
 
 :::
 

docs/build/storage.md

@@ -11,7 +11,7 @@ It offers a powerful and cost-effective object storage solution on the blockchai
 
 :::note
 
-To use Juno Storage's features, you must [install](../add-juno-to-an-app/setup) and initialize the Juno SDK in your app.
+To use Juno Storage's features, you must [install](../setup-the-sdk) and initialize the Juno SDK in your app.
 
 :::
 

docs/add-juno-to-an-app/create-a-satellite.md → docs/create-a-satellite.md

@@ -1,5 +1,4 @@
 ---
-sidebar_position: 1
 description: "Learn how to create a satellite with Juno in this comprehensive guide. Perfect for developers integrating Juno into their projects."
 keywords:
   [
@@ -35,6 +34,6 @@ In the creation wizard, there are advanced options available for more experience
 
 If you wish to have more control over where your satellite is deployed, you can select the [subnet] for deployment during the creation process.
 
-[satellite]: ../terminology.md#satellite
-[Internet Identity]: ../terminology.md#internet-identity
-[subnet]: ../terminology.md#subnet
+[satellite]: terminology.md#satellite
+[Internet Identity]: terminology.md#internet-identity
+[subnet]: terminology.md#subnet

docs/faq.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 10
----
-
 # FAQ
 
 ### Where do I find support?
@@ -50,7 +46,7 @@ In contrast, Juno takes a different approach. Developers pre-charge their smart
 
 ### Do you have a library for [some other language]?
 
-We officially support [JavaScript](./add-juno-to-an-app/setup).
+We officially support [JavaScript](setup-the-sdk).
 
 Community-supported libraries and contributions are warmly welcomed.