diff --git a/docs/help-to-translate.md b/docs/help-to-translate.md
deleted file mode 100644
index dbe5b2e15..000000000
--- a/docs/help-to-translate.md
+++ /dev/null
@@ -1,67 +0,0 @@
-# Help to translate
-
-As you can see we have added 2 more languages to the documentation, if you want to help us with the translation process, now you can do it using the platform crowdin for it.
-
-## How can I collaborate with the translation of DAppNode Documentation?
-
-Requisites:
-
-- A crowdin account
-
-### 1. Crowdin platform
-
-Access https://crowdin.com/project/dappnodedocs.
-
-You will see the following page, where you can select what languages you wish to translate into:
-
-
- 
-
-
-Once you have selected the language, you will see a tree folder with all the files of the documentation. You can see too two statistics:
-
-- Words translated: words that have been translated by someone. They are shown in colour blue.
-- Words approved: words that have been translated and someone has confirmed the translation is correct. Shown in green colour.
-
-
- 
-
-
-Navigate to the file you wish to translate and click on the filename.
-
-
- 
-
-
-In this example, we can see 2 different highlighted sections:
-
-- Red highlight: Text that has not been translated yet.
-- Green highlight: Text that has already been translated.
-
-On this page, you can do 2 things: translate the file and/or vote/approve a translation.
-
-#### 2.1 Add translation
-
-The file is divided in strings or phrases. You need to click on it the phrase you want to translate. If I want to translate the sentence `This documentation has 4 types of content depending on what you want to do:`, I click on it and I see the next image:
-
-
- 
-
-
-Translate the sentence on the right panel, under `Enter translation here`, and click on the SAVE button.
-
-##### 2.1.1 Maintain the style of the text
-
-If the original text has style tags like in the example: `Get Started : you can find what you need to run a DAppNode, hardware recommendations or how to get DAppNode hardware.`, you will need to maintain it.
-
-
- 
-
-
-To do so, copy the tags `Get Started` and change the content inside of them. In this example, the result would be something like:
-
-`Iniciación : you can find what you need to run a DAppNode, hardware recommendations or how to get DAppNode hardware.`
-
-### 2.2 Approve translation or make a different suggestion.
-
-In case there's an already existing translation, you will be able to suggest an alternative translation or to validate it. For this, select the green/blue marked texts and vote up/down for the translation, or suggest an alternative translation.
diff --git a/docs/help-us-translate.md b/docs/help-us-translate.md
new file mode 100644
index 000000000..a6ad1a88a
--- /dev/null
+++ b/docs/help-us-translate.md
@@ -0,0 +1,78 @@
+# Translating the DAppNode Documentation
+---
+So far we have added two additional languages to the documentation. If you want to help us by translating the documentation, you can do that via the Crowdin platform as shown below.
+
+## Project Overview
+
+Access our [Crowdin project here](https://crowdin.com/project/dappnodedocs)
+
+Prerequisites for doing so:
+
+- A Crowdin account
+
+### Available languages
+On the project page you will see the available languages you can contribute to:
+
+
+
+
+
+### Files to be translated
+
+Once you have selected the language, you will see a tree-style directory view of all the files containing the documentation. You can also see two additional statistics:
+
+- Words translated: words that have been translated by someone. They represent the **blue part** of the bar.
+- Words approved: words that have been translated and someone confirmed that the translation is accurate. They represent the **green part** of the bar.
+
+Below you can see an example for the spanish translation.
+
+
+
+
+
+## Translating and voting
+
+### Selecting a file
+Now you can navigate to a file that you wish to translate and click on the name of the file (**intro.md** in the example).
+
+
+
+
+
+Here we can see 2 different highlighted sections:
+
+- **Red** highlight: Text that has not been translated yet.
+- **Green** highlight: Text that has already been translated.
+
+On this page you can translate the content and/or vote/approve a translation.
+
+### Adding your translation to the documentation
+
+A file is divided into strings or phrases. You need to click on the string or phrase you wish to translate.
+
+If I want to translate the following string: `This documentation has 4 types of content depending on what you want to do:`, I click on it and the text shows up in the `Source string` box:
+
+
+
+
+
+Translate the sentence on the right panel, under `Enter translation here`, and click on the SAVE button.
+
+### Maintaining the formatting and style of the original text
+
+If the original text has style tags like those in the example:
+`Get Started : you can find what you need to run a DAppNode, hardware recommendations or how to get DAppNode hardware.`
+
+You will need to keep those tags and make them work in your translation.
+
+
+
+
+
+To do so, copy those tags `Get Started` and change the content inside of them. Rearrange them if needed. In this example, the result would be something like this:
+
+`Iniciación : you can find what you need to run a DAppNode, hardware recommendations or how to get DAppNode hardware.`
+
+### Approve existing translations or submit a change
+
+In case there's already an existing translation, you will be able to suggest an alternative translation or to approve the translation. To do this, select the green/blue highlighted string and upvote/downvote the translation; or suggest an alternative translation.
diff --git a/docs/user.md b/docs/user.md
index 49b7fe064..ff034ebe1 100644
--- a/docs/user.md
+++ b/docs/user.md
@@ -3,11 +3,13 @@ title: User Guide
slug: "/"
---
-Wellcome to the DAppNode user guide.
-If you have just installed or bought a DAppNode, the section quick start will help you to do the first step on your DAppNode.
+Welcome to the DAppNode user guide.
+===
+---
+If you have just installed DAppNode on your own hardware or bought a DAppNode from our [store](https://shop.dappnode.io/), the [Quick Start section](/user/quick-start/home) will help you through the first steps with your DAppNode.
-If you want to validate or know how to do cool stuff go to the guides section.
+If you want to run your own validator, access decentralised apps or learn how to do cool stuff on your DAppNode visit the [Guides section](/user/guides).
-If you have some problem or doubt about dappnode, go to the FAQS.
+If you have problems with your DAppNode or want to get in touch with us, please take a look at the [FAQs](/user/faq/general).
-The product manual will show you what does every button and part of the UI.
+The [product manual](/user/product-manual/dashboard) aims to give you an overview of the whole DAppNode interface, accompanied by a functional explanation of that part of the UI.
\ No newline at end of file
diff --git a/docs/user/faqs/general.md b/docs/user/faq/general.md
similarity index 100%
rename from docs/user/faqs/general.md
rename to docs/user/faq/general.md
diff --git a/docs/user/faqs/howtoguides.md b/docs/user/faq/howtoguides.md
similarity index 100%
rename from docs/user/faqs/howtoguides.md
rename to docs/user/faq/howtoguides.md
diff --git a/docs/user/faqs/troubleshooting.md b/docs/user/faq/troubleshooting.md
similarity index 100%
rename from docs/user/faqs/troubleshooting.md
rename to docs/user/faq/troubleshooting.md
diff --git a/docusaurus.config.js b/docusaurus.config.js
index fd2c7db7f..c6d82590e 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -24,7 +24,7 @@ module.exports = {
type: 'localeDropdown',
dropdownItemsAfter: [
{
- to: '/help-to-translate',
+ to: '/help-us-translate',
label: 'Help Us Translate',
},
],
@@ -62,7 +62,7 @@ module.exports = {
},
{
label: 'Discord',
- href: 'https://discord.com/invite/c28an8dA5k',
+ href: 'https://discord.com/invite/dappnode',
},
{
label: 'Twitter',
diff --git a/sidebars.js b/sidebars.js
index 890249575..bffa186b8 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -47,11 +47,11 @@ module.exports = {
},
{
type: 'category',
- label: 'FAQS',
+ label: 'FAQ',
items: [
{
type: 'autogenerated',
- dirName: 'user/faqs',
+ dirName: 'user/faq',
},
],
},