Merge pull request #3244 from davidekete/fix-broken-links

Fix broken links

Author: ryestew

docs/FAQ.md

@@ -18,7 +18,7 @@
 
 `Ctrl+S`: Compiles the active Solidity file
 
-`Ctrl+Shift+S`: Compiles a Solidity file and runs a script when the script is displayed in the editor.<br>(go [here](running_js_scripts.html#compile-a-contract-and-run-a-script-on-the-fly) for more info about this functionality)
+`Ctrl+Shift+S`: Compiles a Solidity file and runs a script when the script is displayed in the editor.<br>(go {ref}`here <running_js_scripts:compile a contract and run a script in one click>` for more info about this functionality)
 
 `Ctrl+Shift+F` : Opens the File Explorer
 
@@ -108,7 +108,7 @@ The input of initPeepToPeeps takes a struct. If you input
 
 **Q:** Where do plugin developers go with their questions?
 
-**A:** First, join our [Discord server](https://discord.gg/zUNteAzJs3) and then go to the development-plugin channel.
+**A:** First, join our [Discord server](https://discord.com/invite/zUNteAzJs3) and then go to the development-plugin channel.
 
 ### Analytics
 

docs/community.md

@@ -1,6 +1,6 @@
 # Community Support
 
-Do you have questions about Remix? Join our [Discord](https://discord.gg/nfv6ZYjAeP) server and get some help!
+Do you have questions about Remix? Join our [Discord](https://discord.com/invite/nfv6ZYjAeP) server and get some help!
 
 We post announcements and tips on [Twitter](https://twitter.com/ethereumremix).
 

docs/compile.md

@@ -60,14 +60,14 @@ When you publish your metadata to IPFS and deploy your code to the mainnet or a
 
 ### Compile and Run script
 
-The Compile and Run script button (**E. in fig. 1**) is for compiling and then immediately running a script. It's a time saver so that you can write some code, automatically run script that sets state of the contract - thus allowing you to quickly understand how the code is working. ([more about Compile & Run](running_js_scripts.html?#compile-a-contract-and-run-a-script-on-the-fly))
+The Compile and Run script button (**E. in fig. 1**) is for compiling and then immediately running a script. It's a time saver so that you can write some code, automatically run script that sets state of the contract - thus allowing you to quickly understand how the code is working. Learn {ref}`more about Compile and Run <running_js_scripts:compile a contract and run a script in one click>`.
 
 ### Compilation Errors and Warning
 
 Compilation Errors and Warning are displayed below the contract section.
 At each compilation, the static analysis tab builds a report.
 
-It is important to address reported issues even if the compiler doesn't complain. ([more about static analysis](static_analysis.html))
+It is important to address reported issues even if the compiler doesn't complain. ({doc}`more about static analysis </static_analysis>`)
 
 ## Advanced Compiler Configurations
 
@@ -93,7 +93,7 @@ To see the name of the hard fork used in the current compilation, click the "Com
 
 According to the Solidity Docs, "the optimizer tries to simplify complicated expressions, which reduces both code size and execution cost, i.e., it can reduce gas needed for contract deployment as well as for external calls made to the contract."
 
-For recent versions of Solidity, it is [recommended to enable optimization](https://blog.soliditylang.org/2020/11/04/solidity-ama-1-recap/#why-do-you-think-people-are-generally-suspicious-of-the-optimizer-and-are-they-right-to-be).
+For recent versions of Solidity, it is [recommended to enable optimization](https://soliditylang.org/blog/2020/11/04/solidity-ama-1-recap/#:~:text=Why%20do%20you%20think%20people%20are%20generally%20suspicious%20of%20the%20optimizer%2C%20and%20are%20they%20right%20to%20be%3F).
 
 To learn more about optimization, (**Q. in the fig 2**) visit the [Solidity docs on the optimizer](https://docs.soliditylang.org/en/latest/internals/optimizer.html).
 

docs/conf.py

@@ -30,9 +30,10 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['myst_parser', 'sphinx_copybutton'] # required for sphinx v3.0.0
+extensions = ['myst_parser', 'sphinx_copybutton', 'sphinx.ext.autosectionlabel'] # required for sphinx v3.0.0
 copybutton_prompt_text = r">>> |\$ "
 copybutton_prompt_is_regexp = True
+autosectionlabel_prefix_document = True
 
 # suppress warnings caused by non-consecutive header
 # see more details here https://myst-parser.readthedocs.io/en/latest/faq/index.html#suppress-warnings

docs/create_deploy.md

@@ -14,7 +14,7 @@ Let's go through a basic workflow:
 
 In the File Explorer, create a new file by clicking on the new file icon, and name it. The `.sol` is default extension in Remix, if a file is named without an extension, `.sol` will appended.
 
-**NOTE:** For information about templates or workspaces, see the [File Explorer docs](file_explorer.html).
+**NOTE:** For information about templates or workspaces, see the {doc}`File Explorer docs </file_explorer>`.
 
 In the editor, paste in the following contract into the empty file:
 
@@ -53,13 +53,14 @@ When pasting in code, make sure you understand it before deploying or interactin
 With the contract above as the active tab in the Editor, compile the contract.  
 A quick way to compile is to hit **ctrl + s**. You can also compile by going to the Solidity Compiler and clicking the compile button, or by right clicking a file in the File Explorer, or by clicking the play button at the top of the Editor.
 
-**For More Info** see the docs on the [Solidity Compiler](compile.html).
+**For More Info** see the docs on the {doc}`Solidity Compiler </compile>`.
 
 ## Deploy the contract
 
 Go to the **Deploy & Run Transactions** plugin.
 
-At the top of this plugin is the Environment selectbox. Here you can choose where you want to deploy your contract. There are many choices. For more info about these options see [this section](run.html#environment) of the docs.
+
+At the top of this plugin is the Environment selectbox. Here you can choose where you want to deploy your contract. There are many choices. For more info about these options see {ref}`this section <run:environment>` of the docs.
 
 For a brief synopsis:
 

docs/debugger.md

@@ -12,15 +12,15 @@ To start a debugging session either:
 
 The debugger will highlight the relevant code in the Editor. If you want to go back to editing the code without the Debugger's highlights, then click the **Stop Debugging** button.
 
-To learn more about how to use this tool go to the [Debugging Transactions](tutorial_debug.html) page.
+To learn more about how to use this tool go to the {doc}`Debugging Transactions </tutorial_debug>` page.
 
 This page will go over the Debugger's _Use generated sources_ option, its navigation and its panels.
 
 ![](images/a-debugger-overview.png)
 
 ## Use generated sources
 
-This option is available for contracts using Solidity 0.7.2 or greater. See the solidity blog for more details about [generated sources](https://blog.soliditylang.org/2020/09/28/solidity-0.7.2-release-announcement/#notable-new-features).
+This option is available for contracts using Solidity 0.7.2 or greater. See the solidity blog for more details about [generated sources](https://soliditylang.org/blog/2020/09/28/solidity-0.7.2-release-announcement/#:~:text=Notable%20New%20Features).
 
 Using **generated sources** will make it easier to audit your contracts. When the option is checked, you can step into those compiler outputs — while debugging.
 
@@ -164,4 +164,4 @@ Breakpoints can be placed in the gutter of the Editor to pause the debugger.
 
 The debugger's granular information gives users detailed information about what is happening in a transaction - so not only is the debugger good for debugging, it is also an excellent teaching tool.
 
-To learn about using the debugger, go to [Debugging Transactions](tutorial_debug.html).
+To learn about using the debugger, go to {doc}`Debugging Transactions </tutorial_debug>`.

docs/file_explorer.md

@@ -28,7 +28,7 @@ There are two ways you can save the files you create and use on Remix to your ha
 
 #### Remixd
 
-Remixd is an NPM package that allows you to share a specified folder on your computer with Remix IDE. Thus, your files are saved on IndexedDB and on the specified folder. Learn more about Remixd on our [Remixd guide](remixd.html).
+Remixd is an NPM package that allows you to share a specified folder on your computer with Remix IDE. Thus, your files are saved on IndexedDB and on the specified folder. Learn more about Remixd on our {doc}`Remixd guide </remixd>`.
 
 #### Remix Desktop
 

docs/git.md

@@ -16,16 +16,16 @@ Alternatively, you can add username and email to the Github section of the Git p
 
 ### Initializing Git in a Workspace
 
-For information about initializing a workspace, see the section about initializing Git on the [Remix Workspaces](/workspaces/#initializing-a-workspace-with-git) page.
+For information about initializing a workspace, see the section about initializing Git on the {ref}`Remix Workspaces <workspaces:initializing a workspace with git>` page.
 
 ### Cloning an existing repository into Remix
 
 You can clone an existing repository from GitHub into Remix using "**CLONE**" accordion item in the Git plugin. You can clone a repository by loading it from GitHub using the "**Load from GitHub**" button and selecting one from your list of public repositories.
 
-Alternatively, you can clone a repository by providing its URL in the "**CLONE FROM URL**" text box. When you clone a repository, Remix initializes it as a separate Workspace. See [Remix Workspaces](/workspaces) to learn more about Workspaces.
+Alternatively, you can clone a repository by providing its URL in the "**CLONE FROM URL**" text box. When you clone a repository, Remix initializes it as a separate Workspace. See {doc}`Remix Workspaces <workspaces>` to learn more about Workspaces.
 
 ```{note}
-Remix stores your files in the browser and browser storage is limited. Cloning a repository that is too large will cause the Remix IDE. This is why you have to manually specify the depth and branches you want to clone. If you are using [Remixd](/remixd) you don't have to worry about cloning large repositories.
+Remix stores your files in the browser and browser storage is limited. Cloning a repository that is too large will cause the Remix IDE. This is why you have to manually specify the depth and branches you want to clone. If you are using {doc}`Remixd </remixd>` you don't have to worry about cloning large repositories.
 ```
 
 ![Remix Git plugin clone section.](images/git/gh-clone.png)

docs/hardhat.md

@@ -4,7 +4,9 @@ _(Supported since Remix IDE v0.12.0 and Remixd v0.3.6)_
 
 ## Remixd and Hardhat
 
-**Note:** If you have not used `remixd` before, read more about it [here](./remixd.html)
+```{note}
+If you have not used `remixd` before, read more about it {doc}`in the Remixd documentation </remixd>`.
+```
 
 If `remixd` is running locally on your device and shared folder is a **Hardhat project**, an additional websocket plugin will be listening on port `65522`. According to its documentation,
 
@@ -30,7 +32,7 @@ To use Hardhat compilation with Remix IDE efficiently:
 
 ### How to use
 
-If a hardhat project is shared through remixd and `localhost` workspace is loaded in Remix IDE, there will be an extra checkbox shown in `Solidity Compiler` plugin with the label `Enable Hardhat Compilation`.
+If a hardhat project is shared through Remixd and `localhost` workspace is loaded in Remix IDE, there will be an extra checkbox shown in `Solidity Compiler` plugin with the label `Enable Hardhat Compilation`.
 
 ![](images/a-hardhat-compilation.png)
 

docs/import.md

@@ -63,7 +63,7 @@ import "./myLovelyLovelyLib.sol";
 
 ### Importing a file from your computer's filesystem
 
-This method uses **remixd** - the remix daemon. Please go to the [remixd docs](remixd.html) for instructions about how to bridge the divide between the browser and your computer's filesystem.
+This method uses **remixd** - the remix daemon. Please go to the {doc}`remixd docs </remixd>` for instructions about how to bridge the divide between the browser and your computer's filesystem.
 
 ### More about the import keyword