From 9f91cf2248480711aacefbe997db13f108c4393c Mon Sep 17 00:00:00 2001 From: thomas-senechal Date: Mon, 6 Nov 2023 10:03:07 +0100 Subject: [PATCH] Fix typo in manual install introduction and format pages --- docs/massaStation/faq.mdx | 20 +++++++------------- docs/massaStation/home.mdx | 1 + docs/massaStation/manual-install.mdx | 13 +++++++++---- docs/massaStation/troubleshooting.mdx | 5 +---- 4 files changed, 18 insertions(+), 21 deletions(-) diff --git a/docs/massaStation/faq.mdx b/docs/massaStation/faq.mdx index 50e950912..e9b8ac309 100644 --- a/docs/massaStation/faq.mdx +++ b/docs/massaStation/faq.mdx @@ -9,58 +9,52 @@ title: FAQ You can install Massa Station by following the instructions on the [installation page](/docs/massaStation/install). - ### How do I update Massa Station? You can update Massa Station by following the same instructions as the installation process. You can find the instructions on the [installation page](/docs/massaStation/install). - ### How do I uninstall Massa Station? You can uninstall Massa Station by following the instructions on the [uninstallation page](/docs/massaStation/uninstall). - ### Installation failed, what do I do? If you are having trouble installing Massa Station, please check the [installation troubleshooting page](/docs/massaStation/troubleshooting) for help. - ### Installation fails because of unsupported OS version. What to do? For now, Massa Station is only supported on Windows 10 and 11, MacOS 12 and later, and Debian based Linux distributions. If you are using an unsupported operating system, you can still try to install Massa Station manually by following the instructions on the [manual installation page](/docs/massaStation/manual-install). - ### Antivirus blocked installation of Massa Station. What to do? -We want to assure you that Massa Station is free from viruses, and the antivirus warning is a false positive. We're in the process of obtaining necessary certificates (such as from Apple for MacOS versions), which can trigger such warnings. +We want to assure you that Massa Station is free from viruses, and the antivirus warning is a false positive. We're in the process of obtaining necessary certificates (such as from Apple for MacOS versions), which can trigger such warnings. Being a blockchain app, Massa Station interacts with distant servers and performs cryptographic operations. Antivirus warnings for new apps in this category are common but are mostly not indicative of any threat. If you are using an antivirus that blocks Massa Station, you can try to add Massa Station to the whitelist. Massa Station’s code is publicly accessible and auditable on [GitHub](https://github.com/massalabs/station), which means that anybody can check what’s happening. It’s part of our commitment to transparency and security. - ## Massa Station Usage ### How do I use Massa Station? We have detailed instructions on how to use Massa Station such as: + - [Browse Decentralized Apps](/docs/massaStation/browse-decentralized-application) - [Install Massa Wallet](/docs/massaStation/massa-wallet/getting-started) - ### Why can't I use Massa Station on mobile? Massa Station is a desktop super-app that, once opened, operates within your web browser. A mobile version is not available at this time. - -### Why can't I see modules in module store? +### Why can't I see modules in module store? The module store is hosted on GitHub. If you are in a country that blocks GitHub, you will not be able to see the modules. We are working on a solution to this problem, but in the meantime, you can install modules manually using the right panel of the module store. For example with the Massa Wallet module: + 1. Go to the [latest Massa Wallet release page](https://github.com/massalabs/station-massa-wallet/releases/latest). 2. Copy the URL of the `.zip` file corresponding to your operating system. 3. Paste the URL in the right panel of the module store and click on "Install". @@ -73,14 +67,14 @@ If Massa Station is running, please check that you are using the correct URL. Th If you are still having trouble accessing Massa Station, please check the [troubleshooting page](/docs/massaStation/troubleshooting) for help. +### "Install" module button doesn't work. What to do? -### "Install" module button doesn't work. What to do? - -This is a known issue that happens when a module is stored on GitHub. We are investigating the issue. +This is a known issue that happens when a module is stored on GitHub. We are investigating the issue. In the meantime, you can install the module manually by following the instructions on the right panel of the module store. For example with the Massa Wallet module: + 1. Go to the [latest Massa Wallet release page](https://github.com/massalabs/station-massa-wallet/releases/latest). 2. Copy the URL of the `.zip` file corresponding to your operating system. 3. Paste the URL in the right panel of the module store and click on "Install". diff --git a/docs/massaStation/home.mdx b/docs/massaStation/home.mdx index 39c890367..601dd9c48 100644 --- a/docs/massaStation/home.mdx +++ b/docs/massaStation/home.mdx @@ -44,6 +44,7 @@ adoption of the Massa Blockchain. - [Hello World Plugin](/docs/massaStation/hello-world-plugin) ## Other Resources + - [Massa Station FAQ](/docs/massaStation/faq) - [Manual Installation](/docs/massaStation/manual-install) - [Uninstall Massa Station](/docs/massaStation/uninstall) diff --git a/docs/massaStation/manual-install.mdx b/docs/massaStation/manual-install.mdx index 4c1fc04a4..694f94594 100644 --- a/docs/massaStation/manual-install.mdx +++ b/docs/massaStation/manual-install.mdx @@ -4,6 +4,7 @@ title: Manual Install --- :::caution + ## Disclaimer This guide is intended for advanced users who are familiar with the command line and system administration. @@ -11,7 +12,8 @@ This guide is intended for advanced users who are familiar with the command line ## Installation -If you are unable to install _Massa Station_ using the methods described above, or simply prefer to install it manually, you can follow these steps: +If you are unable to install _Massa Station_ using the methods described in the [Installation](/docs/massaStation/install) section, +or simply prefer to install it manually, you can follow these steps: 1. Download the latest version of the _Massa Station_ binary for your operating system from [here](https://github.com/massalabs/station/releases/latest). :::caution @@ -36,11 +38,13 @@ If you are unable to install _Massa Station_ using the methods described above, 4. Run the binary to start _Massa Station_. 5. Open your browser and navigate to `http://localhost/` to access _Massa Station_. -This method of installation will not install the necessary dependencies for _Massa Station_ to function correctly and so, features such as HTTPS support and accessing `.massa` domains will not work. +This method of installation will not install the necessary dependencies for _Massa Station_ to function correctly and so, +features such as HTTPS support and accessing `.massa` domains will not work. ### Handle `station.massa` redirection -If you want to access _Massa Station_ by typing `station.massa` in your browser's address bar, you will need to configure your system to redirect requests to `station.massa` to `localhost`. +If you want to access _Massa Station_ by typing `station.massa` in your browser's address bar, you will need to configure your system to redirect +requests to `station.massa` to `localhost`. You can make this change by editing the 'hosts' file on your computer, regardless of whether you're using Windows, MacOS, or Linux: 1. Open the 'hosts' file, which is located at: @@ -61,7 +65,8 @@ Once installed, you will need to configure the DNS server to redirect all reques ### Add HTTPS support -Massa Station will automatically generate a self-signed certificate for HTTPS support when it is first run, but to do it, it requires some dependencies to be installed on your system. +Massa Station will automatically generate a self-signed certificate for HTTPS support when it is first run, but to do it, +it requires some dependencies to be installed on your system. #### Windows diff --git a/docs/massaStation/troubleshooting.mdx b/docs/massaStation/troubleshooting.mdx index 5b1526752..b9f21f0fe 100644 --- a/docs/massaStation/troubleshooting.mdx +++ b/docs/massaStation/troubleshooting.mdx @@ -47,7 +47,6 @@ If you used the GUI installation method, please try to install Massa Station usi If you used the Terminal installation method, please send us the output of the command you used to install Massa Station. - ## Massa Station ### Massa Station isn't starting @@ -62,8 +61,7 @@ listen tcp :80: bind: address already in use That means that another application is already using the port 80. You can either stop the application using the port 80 or change its port. - -### I get a page with the error "DNS_PROBE_FINISHED_NXDOMAIN" +### I get a page with the error "DNS_PROBE_FINISHED_NXDOMAIN" This error means that your computer can't resolve the domain name of Massa Station. This can happen in multiple cases: @@ -92,7 +90,6 @@ In Chromium based browsers, you can go to your browser settings and search for " If the problem persists, please open an issue with the logs of Massa Station as explained in the [Get Massa Station logs](#get-massa-station-logs) section. - ### I get a page with the error "ERR_CONNECTION_REFUSED" This error means that your computer can't connect to Massa Station.