From 280652166f906ba2578fe24a00fa3273fae2ff4c Mon Sep 17 00:00:00 2001 From: Mik-TF Date: Mon, 13 May 2024 19:10:10 -0400 Subject: [PATCH] manual set urls for external collection --- collections/about/genesis_pool.md | 2 +- collections/about/token_history.md | 2 +- collections/collaboration/collaboration_toc.md | 2 +- .../collaboration_tools/circle_tool.md | 2 +- .../collaboration/development_process.md | 2 +- .../dashboard/deploy/dedicated_machines.md | 4 ++-- collections/dashboard/farms/your_farms.md | 4 ++-- collections/dashboard/home.md | 2 +- collections/dashboard/solutions/fullvm.md | 2 +- collections/dashboard/solutions/nixos_micro.md | 2 +- collections/dashboard/tfchain/tf_dao.md | 6 +++--- .../internals/zos/development/packages.md | 4 ++-- .../internals/zos/development/quickstart.md | 4 ++-- .../internals/zos/development/testing.md | 2 +- collections/developers/tfcmd/tfcmd.md | 2 +- collections/faq/faq.md | 10 +++++----- .../farmers/3node_building/1_create_farm.md | 2 +- .../farmers/3node_building/4_wipe_all_disks.md | 2 +- .../farmers/3node_building/gpu_farming.md | 2 +- .../farmers/3node_building/minting_receipts.md | 2 +- .../3node_diy_desktop/3node_diy_desktop.md | 6 +++--- .../3node_diy_rack_server.md | 4 ++-- collections/farmers/farmers.md | 4 ++-- .../set_additional_fees.md | 4 ++-- collections/farming/farming_intro.md | 2 +- collections/farming/farming_reward.md | 3 +-- .../farming/farming_reward_calculation.md | 4 ++-- collections/farming/farming_toc.md | 2 +- collections/farming/poc_dao_rules.md | 2 +- collections/farming/proof_of_capacity.md | 4 ++-- collections/farming/proof_of_utilization.md | 8 ++++---- .../advanced/cancel_contracts.md | 4 ++-- .../advanced/grid3_stellar_tfchain_bridge.md | 6 +++--- .../getstarted/tfgrid3_getstarted.md | 12 ++++++------ .../getstarted/tfgrid3_what_to_know.md | 2 +- collections/system_administrators/gpu/gpu.md | 4 ++-- .../system_administrators/gpu/gpu_toc.md | 18 +++++++++--------- .../advanced/terraform_nextcloud_vpn.md | 4 ++-- .../terraform/resources/terraform_vm.md | 2 +- .../terraform/terraform_basics.md | 4 ++-- 40 files changed, 79 insertions(+), 80 deletions(-) diff --git a/collections/about/genesis_pool.md b/collections/about/genesis_pool.md index ad6fdb2..25552de 100644 --- a/collections/about/genesis_pool.md +++ b/collections/about/genesis_pool.md @@ -64,7 +64,7 @@ The tokens were used from out of ThreeFold_Dubai to create value for the ThreeFo ## Remarks -- ThreeFold_Dubai is run as a [not-for-profit organization](../legal/definitions_legal.md) +- ThreeFold_Dubai is run as a [not-for-profit organization](legal@@definitions_legal) - All (future) profits generated, tokens=IT capacity sold are used to promote and grow the ThreeFold Project. - None of the potential profits generated go to the shareholders of the company. - Investments and loans given will of course be paid back to the relevant investors. \ No newline at end of file diff --git a/collections/about/token_history.md b/collections/about/token_history.md index 7d9c7a2..ee49ab4 100644 --- a/collections/about/token_history.md +++ b/collections/about/token_history.md @@ -81,7 +81,7 @@ In Q3 2021 we launched TF Grid 3.0 which has again brought improvement to the fa ### Migration from TFTv1 Stellar (Staking Pool=TFTA) to TFTv2 Stellar (Trading or Production Pool=TFT) -- See [TFTA to TFT](../legal/terms_conditions/tfta_to_tft.md) +- See [TFTA to TFT](legal@@tfta_to_tft) ### Technical Information diff --git a/collections/collaboration/collaboration_toc.md b/collections/collaboration/collaboration_toc.md index 3a6bc41..b99597c 100644 --- a/collections/collaboration/collaboration_toc.md +++ b/collections/collaboration/collaboration_toc.md @@ -2,7 +2,7 @@ ThreeFold strongly believes in the power of open-source projects and community-driven collaboration. The following documentation is ideal for anyone who wants to know ways to collaborate to the ThreeFold ecosystem. -To become a farmer, a developer or a sysadmin on the ThreeFold, read the [documentation](../../documentation/documentation.md). +To become a farmer, a developer or a sysadmin on the ThreeFold, read the [documentation](manual@@documentation).

Table of Contents

Table of Contents diff --git a/collections/dashboard/solutions/fullvm.md b/collections/dashboard/solutions/fullvm.md index 59b01e6..774714f 100644 --- a/collections/dashboard/solutions/fullvm.md +++ b/collections/dashboard/solutions/fullvm.md @@ -43,7 +43,7 @@ Deploy a new full virtual machine on the Threefold Grid - `Myceluim` to enable mycelium on the virtual machine - `Wireguard Access` to add a wireguard access to the Virtual Machine - `GPU` flag to add GPU to the Virtual machine - - To deploy a Full VM with GPU, you first need to [rent a dedicated node](../../dashboard/deploy/dedicated_machines.md) + - To deploy a Full VM with GPU, you first need to [rent a dedicated node](dashboard@@dedicated_machines) - `Dedicated` flag to retrieve only dedicated nodes - `Certified` flag to retrieve only certified nodes - Choose the location of the node diff --git a/collections/dashboard/solutions/nixos_micro.md b/collections/dashboard/solutions/nixos_micro.md index 41f8932..2e6a91f 100644 --- a/collections/dashboard/solutions/nixos_micro.md +++ b/collections/dashboard/solutions/nixos_micro.md @@ -55,7 +55,7 @@ We now present the main steps to properly configure your NixOS MicroVM running o * Once your configured the parameters, you can deploy the MicroVM. -If you need more information on how to SSH into your deployment, read [this section](../../system_administrators/getstarted/tfgrid3_getstarted.md) of the TF Manual. +If you need more information on how to SSH into your deployment, read [this section](system_administrators@@tfgrid3_getstarted) of the TF Manual. diff --git a/collections/dashboard/tfchain/tf_dao.md b/collections/dashboard/tfchain/tf_dao.md index 648280b..be2cf0e 100644 --- a/collections/dashboard/tfchain/tf_dao.md +++ b/collections/dashboard/tfchain/tf_dao.md @@ -13,7 +13,7 @@ The TFChain DAO (i.e. Decentralized Autonomous Organization) feature integrates ## An Introduction to the DAO concept -[A decentralized autonomous organization (DAO)](../../../knowledge_base/about/dao/dao.md) is an entity with no central leadership. Decisions get made from the bottom-up, governed by a community organized around a specific set of rules enforced on a blockchain. +[A decentralized autonomous organization (DAO)](about@@dao) is an entity with no central leadership. Decisions get made from the bottom-up, governed by a community organized around a specific set of rules enforced on a blockchain. DAOs are internet-native organizations collectively owned and managed by their members. They have built-in treasuries that are only accessible with the approval of their members. Decisions are made via proposals the group votes on during a specified period. @@ -24,9 +24,9 @@ DAOs are internet-native organizations collectively owned and managed by their m Voting for a DAO proposal is very simple. You first need to meet certain requirements to be able to vote. - Have a [Threefold farm](../farms/farms.md) -- Have at least one active [3node server](../../farmers/3node_building/3node_building.md) on the farm +- Have at least one active [3node server](farmers@@3node_building) on the farm - If you created your farm with the Threefold Connect app - - [Import your farm on the Threefold Dashboard](../../threefold_token/storing_tft/tf_connect_app.md#move-farm-from-the-tf-connect-app-to-the-tf-portal-polkadotjs) + - [Import your farm on the Threefold Dashboard](threefold_token@@tf_connect_app.md#move-farm-from-the-tf-connect-app-to-the-tf-portal-polkadotjs) diff --git a/collections/developers/internals/zos/development/packages.md b/collections/developers/internals/zos/development/packages.md index f7391f6..1e76a10 100644 --- a/collections/developers/internals/zos/development/packages.md +++ b/collections/developers/internals/zos/development/packages.md @@ -1,6 +1,6 @@ # Adding a new package -Binary packages are added via providing [a build script](../../bins/), then an automated workflow will build/publish an flist with this binary. +Binary packages are added via providing a build script, then an automated workflow will build/publish an flist with this binary. For example, to add `rmb` binary, we need to provide a bash script with a `build_rmb` function: @@ -43,7 +43,7 @@ build_rmb() { Note that, you can just download a statically build binary instead of building it. -The other step is to add it to workflow to be built automatically, in [bins workflow](../../.github/workflows/bins.yaml), add your binary's job: +The other step is to add it to workflow to be built automatically, in bins workflow, add your binary's job: ```yaml jobs: diff --git a/collections/developers/internals/zos/development/quickstart.md b/collections/developers/internals/zos/development/quickstart.md index 17a4fb1..10f461a 100644 --- a/collections/developers/internals/zos/development/quickstart.md +++ b/collections/developers/internals/zos/development/quickstart.md @@ -26,13 +26,13 @@ You should see the qemu console and boot logs, wait for awhile and you can [brow To stop the machine you can do `Control + a` then `x`. -You can read more about setting up a qemu development environment and more network options [here](../../qemu/README.md). +You can read more about setting up a qemu development environment and more network options [here](qemu_readme.md). ## Accessing node After booting up, the node should start downloading external packages, this would take some time depending on your internet connection. -See [how to ssh into it.](../../qemu/README.md#to-ssh-into-the-machine) +See [how to ssh into it.](qemu_readme.md#to-ssh-into-the-machine) How to get the node IP? Given the network script `dhcp-range`, it usually would be one of `192.168.123.43`, `192.168.123.44` or `192.168.123.45`. diff --git a/collections/developers/internals/zos/development/testing.md b/collections/developers/internals/zos/development/testing.md index 8f023ec..d2a9a27 100644 --- a/collections/developers/internals/zos/development/testing.md +++ b/collections/developers/internals/zos/development/testing.md @@ -21,7 +21,7 @@ While deploying on your local node, logs with `zinit log` would be helpful to se ## Using a test app -If you need to test a specific module or functionality, you can create a simple test app inside e.g. [tools directory](../../tools/). +If you need to test a specific module or functionality, you can create a simple test app inside e.g. tools directory. Inside this simple test app, you can import any module or talk to another one using [zbus](../internals/internals.md#ipc). diff --git a/collections/developers/tfcmd/tfcmd.md b/collections/developers/tfcmd/tfcmd.md index daa502a..b0653ae 100644 --- a/collections/developers/tfcmd/tfcmd.md +++ b/collections/developers/tfcmd/tfcmd.md @@ -2,7 +2,7 @@ TFCMD (`tfcmd`) is a command line interface to interact and develop on Threefold Grid using command line. -Consult the [ThreeFoldTech TFCMD repository](https://github.com/threefoldtech/tfgrid-sdk-go/tree/development/grid-cli) for the latest updates. Make sure to read the [basics](../../system_administrators/getstarted/tfgrid3_getstarted.md). +Consult the [ThreeFoldTech TFCMD repository](https://github.com/threefoldtech/tfgrid-sdk-go/tree/development/grid-cli) for the latest updates. Make sure to read the [basics](system_administrators@@tfgrid3_getstarted).

Table of Contents

diff --git a/collections/faq/faq.md b/collections/faq/faq.md index dda0496..fb60afb 100644 --- a/collections/faq/faq.md +++ b/collections/faq/faq.md @@ -314,7 +314,7 @@ Apply [here](https://marketplace.3node.global/index.php?dispatch=companies.apply There are 2 ways to create a twin: -You can create a twin via the [ThreeFold Dashboard](../dashboard/wallet_connector.md). +You can create a twin via the [ThreeFold Dashboard](dashboard@@wallet_connector). You can also create a twin via the ThreeFold Connect app. Indeed, a twin is automatically generated while creating a farm. Note that, in this case, the twin will be created on mainnet. @@ -865,7 +865,7 @@ http://[319:3cf0:dd1d:47b9:20c:29ff:fe2c:39be]/ If you can reach this website, it means that you are properly connected. -For more information on how to connect to Yggrasil (and the Planetary Network), read [this guide](../system_administrators/getstarted/ssh_guide/ssh_guide.md). +For more information on how to connect to Yggrasil (and the Planetary Network), read [this guide](system_administrators@@ssh_guide). @@ -1463,7 +1463,7 @@ No, as long as the 3Node is connected to the Internet via an ethernet cable (wif A small DIY 3Node based on a compact office computer will draw under 20W. A full size server will draw around 100W idling. Note that a 3Node actively used on the Grid (proof-of-utilization) will draw more power, but also generate passive income on top of farming if you have a public IP address. -For more information, read thes section [Calculate the Total Electricity Cost of Your Farm](../farmers/farming_optimization/farming_costs.md#calculate-the-total-electricity-cost-of-your-farm) of the Farming Guide. +For more information, read thes section [Calculate the Total Electricity Cost of Your Farm](farmers@@farming_costs) of the Farming Guide. @@ -1621,7 +1621,7 @@ It depends on your 3Node's system. Newer computers and servers will accept UEFI. ### How do I set the BIOS or UEFI of my 3Node? -You can read this [documentation](../farmers/3node_building/5_set_bios_uefi.md) to learn more about BIOS and UEFI settings for a DIY 3Node. +You can read this [documentation](farmers@@5_set_bios_uefi) to learn more about BIOS and UEFI settings for a DIY 3Node. @@ -2068,7 +2068,7 @@ First make sure to wipe the disks and then boot your 3Node. If you've wiped the There can be many different fixes for this error. Here are some troubleshooting tips to test separately: * In BIOS, enable AHCI -* Make sure to [wipe the disks](../farmers/3node_building/4_wipe_all_disks.md) of the 3Nodes +* Make sure to [wipe the disks](farmers@@4_wipe_all_disks) of the 3Nodes * If the 3Node has a RAID Controller: * Disabled the RAID controller, OR; * [Flash the RAID controller](https://fohdeesha.com/docs/perc.html) (i.e. crossflashing), OR; diff --git a/collections/farmers/3node_building/1_create_farm.md b/collections/farmers/3node_building/1_create_farm.md index 6b0d6e6..61ec8cc 100644 --- a/collections/farmers/3node_building/1_create_farm.md +++ b/collections/farmers/3node_building/1_create_farm.md @@ -85,4 +85,4 @@ Farming rewards will be sent to your farming wallet around the 8th of each month ## More Information -For more information, such as setting IP addresses, you can consult the [Dashboard Farms section](../../dashboard/farms/farms.md). \ No newline at end of file +For more information, such as setting IP addresses, you can consult the [Dashboard Farms section](dashboard@@farms). \ No newline at end of file diff --git a/collections/farmers/3node_building/4_wipe_all_disks.md b/collections/farmers/3node_building/4_wipe_all_disks.md index afce8aa..bcc5005 100644 --- a/collections/farmers/3node_building/4_wipe_all_disks.md +++ b/collections/farmers/3node_building/4_wipe_all_disks.md @@ -101,6 +101,6 @@ If you're having issues wiping the disks, you might need to use **--force** or * If you're having trouble getting your disks recognized by Zero-OS, some farmers have had success enabling AHCI mode for SATA in their BIOS. -If you are using a server with onboard storage, you might need to [re-flash the RAID card](faq@@faq.md#is-there-a-way-to-bypass-raid-in-order-for-zero-os-to-have-bare-metals-on-the-system-no-raid-controller-in-between-storage-and-the-grid). +If you are using a server with onboard storage, you might need to re-flash the RAID card. [Read the FAQ](faq@@faq) for more information. diff --git a/collections/farmers/3node_building/gpu_farming.md b/collections/farmers/3node_building/gpu_farming.md index b684163..f355525 100644 --- a/collections/farmers/3node_building/gpu_farming.md +++ b/collections/farmers/3node_building/gpu_farming.md @@ -54,7 +54,7 @@ When a user reserves your 3Node as a dedicated node, you will receive TFT paymen ## Check the GPU Node on the Node Finder -You can use the [Node Finder](../../dashboard/deploy/node_finder.md) on the [TF Dashboard](https://dashboard.grid.tf/) to verify that the node is displayed as having a GPU. +You can use the [Node Finder](dashboard@@node_finder) on the [TF Dashboard](https://dashboard.grid.tf/) to verify that the node is displayed as having a GPU. * On the Dashboard, go to the Node Finder * Under **Node ID**, write the node ID of the GPU node diff --git a/collections/farmers/3node_building/minting_receipts.md b/collections/farmers/3node_building/minting_receipts.md index 2b84f1b..76633d3 100644 --- a/collections/farmers/3node_building/minting_receipts.md +++ b/collections/farmers/3node_building/minting_receipts.md @@ -10,7 +10,7 @@ ## Introduction -Once you have the receipt hash of your node minting, you can get the [minting report](../../dashboard/tfchain/tf_minting_reports.md) of your node. +Once you have the receipt hash of your node minting, you can get the [minting report](dashboard@@tf_minting_reports) of your node. ## Access the Reports diff --git a/collections/farmers/complete_diy_guides/3node_diy_desktop/3node_diy_desktop.md b/collections/farmers/complete_diy_guides/3node_diy_desktop/3node_diy_desktop.md index de74eb0..2662525 100644 --- a/collections/farmers/complete_diy_guides/3node_diy_desktop/3node_diy_desktop.md +++ b/collections/farmers/complete_diy_guides/3node_diy_desktop/3node_diy_desktop.md @@ -82,11 +82,11 @@ You can create a farm with either the ThreeFold Dashboard or the ThreeFold Conne ## Using Dashboard -The Dashboard section contains all the information required to [create a farm](../../../dashboard/farms/your_farms.md). +The Dashboard section contains all the information required to [create a farm](dashboard@@your_farms). ## Using TF Connect App -You can [create a ThreeFold farm](../../../threefold_token/storing_tft/tf_connect_app.md) with the ThreeFold Connect App. +You can [create a ThreeFold farm](threefold_token@@tf_connect_app) with the ThreeFold Connect App. # 2. Create a Zero-OS Bootstrap Image @@ -387,7 +387,7 @@ Once you have your node ID, you can also go on the ThreeFold Dashboard to see yo ## Check the Node Status -You can use the [Node Finder](../../../dashboard/deploy/node_finder.md) on the [TF Dashboard](https://dashboard.grid.tf/) to verify that the node is online. +You can use the [Node Finder](dashboard@@node_finder) on the [TF Dashboard](https://dashboard.grid.tf/) to verify that the node is online. Enter your node ID and click **Apply**. diff --git a/collections/farmers/complete_diy_guides/3node_diy_rack_server/3node_diy_rack_server.md b/collections/farmers/complete_diy_guides/3node_diy_rack_server/3node_diy_rack_server.md index 3686915..e7e1c5e 100644 --- a/collections/farmers/complete_diy_guides/3node_diy_rack_server/3node_diy_rack_server.md +++ b/collections/farmers/complete_diy_guides/3node_diy_rack_server/3node_diy_rack_server.md @@ -272,11 +272,11 @@ You can create a farm with either the ThreeFold Dashboard or the ThreeFold Conne ### Using Dashboard -The Dashboard section contains all the information required to [create a farm](../../../dashboard/farms/your_farms.md). +The Dashboard section contains all the information required to [create a farm](dashboard@@your_farms). ### Using TF Connect App -You can [create a ThreeFold farm](../../../threefold_token/storing_tft/tf_connect_app.md) with the ThreeFold Connect App. +You can [create a ThreeFold farm](threefold_token@@tf_connect_app) with the ThreeFold Connect App. ## Wiping All the Disks diff --git a/collections/farmers/farmers.md b/collections/farmers/farmers.md index 9d5f2f8..f9428a7 100644 --- a/collections/farmers/farmers.md +++ b/collections/farmers/farmers.md @@ -2,7 +2,7 @@ This section covers all practical information on how to become a cloud service provider (farmer) on the ThreeFold Grid. -For complementary information on ThreeFold farming, refer to the [Farming](../../knowledge_base/farming/farming_toc.md) section. +For complementary information on ThreeFold farming, refer to the [Farming](farming@@farming_toc) section. To buy a certified node from an official ThreeFold vendor, check the [ThreeFold Marketplace](https://marketplace.3node.global/). @@ -31,6 +31,6 @@ To buy a certified node from an official ThreeFold vendor, check the [ThreeFold - [Quick Guide](./farmerbot/farmerbot_quick.md) - [Additional Information](./farmerbot/farmerbot_information.md) - [Minting and the Farmerbot](./farmerbot/farmerbot_minting.md) -- [Farmers FAQ](../faq/faq.md#farmers-faq) +- [Farmers FAQ](faq@@faq) > Note: Bugs in the code (e.g. ZOS or other components) can happen. If this is the case, there might be a loss of tokens during minting which won't be refunded by ThreeFold. If there are minting code errors, ThreeFold will try its best to fix the minting code and remint nodes that were affected by such errors. diff --git a/collections/farmers/farming_optimization/set_additional_fees.md b/collections/farmers/farming_optimization/set_additional_fees.md index e1b5437..5da2886 100644 --- a/collections/farmers/farming_optimization/set_additional_fees.md +++ b/collections/farmers/farming_optimization/set_additional_fees.md @@ -11,12 +11,12 @@ ## Introduction -Farmers can set additional fees for their 3Nodes on the [TF Dashboard](https://dashboard.grid.tf/). By doing so, users will then be able to [reserve the 3Node and use it as a dedicated node](../../dashboard/deploy/dedicated_machines.md). +Farmers can set additional fees for their 3Nodes on the [TF Dashboard](https://dashboard.grid.tf/). By doing so, users will then be able to [reserve the 3Node and use it as a dedicated node](dashboard@@dedicated_machines). This can be useful for farmers who provide additional values to their 3Nodes, e.g. a GPU card and/or high-quality hardware. ## Steps -Here are the steps to [set additional fees](../../dashboard/farms/your_farms.md#extra-fees) to a 3Node. +Here are the steps to [set additional fees](dashboard@@your_farms) to a 3Node. * On the Dashboard, go to **Farms** -> **Your Farms** * Under the section **Your Nodes**, locate the 3Node and click **Set Additional Fees** under **Actions** diff --git a/collections/farming/farming_intro.md b/collections/farming/farming_intro.md index 9ba490e..50da7fb 100644 --- a/collections/farming/farming_intro.md +++ b/collections/farming/farming_intro.md @@ -7,7 +7,7 @@ ThreeFold Farming ("Farming") is the process of connecting Internet capacity to ## What is Farming? -{{#include farming_circular.md}} +!!wiki.include page:'farming:farming_circular.md' ## Who can become a farmer on ThreeFold? diff --git a/collections/farming/farming_reward.md b/collections/farming/farming_reward.md index 8eba865..62f811a 100644 --- a/collections/farming/farming_reward.md +++ b/collections/farming/farming_reward.md @@ -59,5 +59,4 @@ The main advantage of PoC to farmers it makes it really easy to run a 3Node. It 5. TFChain will mint the required TFT and send them to account on TFChain of TFFarmer. 6. Everyone can use the [ThreeFold Node Finder](https://dashboard.grid.tf/#/deploy/node-finder/) to see where capacity is available. This info comes from the TFChain. - -{{#include farming_reward_disclaimer.md}} +!!wiki.include page:'farming:farming_reward_disclaimer.md' \ No newline at end of file diff --git a/collections/farming/farming_reward_calculation.md b/collections/farming/farming_reward_calculation.md index a56a9f1..a671094 100644 --- a/collections/farming/farming_reward_calculation.md +++ b/collections/farming/farming_reward_calculation.md @@ -9,7 +9,7 @@ Each 3Node has certain amount of compute, storage and network resources: For making this Internet Capacity available, Farmers are rewarded with TFT. -The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](../../cloudunits/resource_units_calc_cloudunits.md). +The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](cloud@@resource_units_calc_cloudunits). > **Unless explicitly specified otherwise, calculations of "gigabytes" use base > 1024. That is, 1 GB is equal to 1073741824 bytes.** @@ -50,4 +50,4 @@ The reward for above items are linked (pegged) to the USD See below for more info about USD price which will be used to calculate your farming reward as well as any other specifics in relation to farming calculations. -The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Calculator](https://dashboard.grid.tf/calculator/simulator). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form [cloud units](../../cloudunits/cloudunits.md). +The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Calculator](https://dashboard.grid.tf/calculator/simulator). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form [cloud units](cloud@@cloudunits). diff --git a/collections/farming/farming_toc.md b/collections/farming/farming_toc.md index e65db81..166db4f 100644 --- a/collections/farming/farming_toc.md +++ b/collections/farming/farming_toc.md @@ -2,7 +2,7 @@ This section covers the essential information concerning ThreeFold Farming. -To farm on the ThreeFold Grid, refer to the [Farmers](farmers:farmers.md) section. +To farm on the ThreeFold Grid, refer to the [Farmers](farmers@@farmers) section.

Table of Contents

diff --git a/collections/farming/poc_dao_rules.md b/collections/farming/poc_dao_rules.md index 0b0475c..42da3ff 100644 --- a/collections/farming/poc_dao_rules.md +++ b/collections/farming/poc_dao_rules.md @@ -29,7 +29,7 @@ - Make sure you have 50GB SSD capacity min available per logical core (physical core times number of threads it can run), if not your calculated CU will be lower. - Make sure your network connection is good enough, in future it will be measured and part of the Service Level Agreement. -{{#include tfgrid_min_sla.md}} +!!wiki.include page:'farming:tfgrid_min_sla.md' **Important Information around TFT USD Price Used at Registration** diff --git a/collections/farming/proof_of_capacity.md b/collections/farming/proof_of_capacity.md index ae0f9fe..01b3824 100644 --- a/collections/farming/proof_of_capacity.md +++ b/collections/farming/proof_of_capacity.md @@ -63,7 +63,7 @@ Each 3Node has certain amount of compute, storage and network resources: For making this Internet Capacity available, Farmers are rewarded with TFT. -The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](../cloud/resource_units_calc_cloudunits.md). +The amount of resources availabe in a 3Node are translated into compute units (CU), storage units (SU), Network units (NU) and IP addresses (IPAddr) to calculate farming rewards. See also [Cloud Units Calculation For Farming](cloud@@resource_units_calc_cloudunits). > **Unless explicitly specified otherwise, calculations of "gigabytes" use base > 1024. That is, 1 GB is equal to 1073741824 bytes.** @@ -90,4 +90,4 @@ The below table expands on CU, SU, NU and IPAddr and their farming rewards: > **The rewards above are calculated according to the current TFT to USD price in TFChain of 0.08. TFDAO is responsible to change this price in accordance to the current market and liquidity.** -The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Simulator](https://dashboard.grid.tf/#/farms/simulator/). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form of [cloud units](../cloud/cloudunits.md). +The above farming rewards apply for 3Nodes registered in TFChain for ThreeFold Grid v3. Anyone can calculate their potential rewards using the [Farming Reward Simulator](https://dashboard.grid.tf/#/farms/simulator/). The same CU, SU, NU and IPAddr principles apply to the sales of Internet capacity in the form of [cloud units](cloud@@cloudunits). diff --git a/collections/farming/proof_of_utilization.md b/collections/farming/proof_of_utilization.md index e92536e..5b0a25e 100644 --- a/collections/farming/proof_of_utilization.md +++ b/collections/farming/proof_of_utilization.md @@ -23,13 +23,13 @@ Each ThreeFold Grid user can now use this capacity. The ThreeFold Chain ("TFChai Proof-of-utilization is the underlying mechanisms that verifies the utilization of Internet capacity on the ThreeFold Grid. -Every hour, the utilization is recorded in TFChain and the user is charged for the Internet capacity used on the ThreeFold Grid. Discount calculated in line with the amount of TFT users have in their accounts on TFChain. Learn more about the discount [here](../cloud/pricing/staking_discount_levels.md). +Every hour, the utilization is recorded in TFChain and the user is charged for the Internet capacity used on the ThreeFold Grid. Discount calculated in line with the amount of TFT users have in their accounts on TFChain. Learn more about the discount [here](cloud@@staking_discount_levels). ## How does Proof-of-Utilization work? 1. A user reserves Internet capacity on a given set of 3Nodes. 2. Zero-OS records the reserved and used CU, SU, NU and IPAddresses in correlation with TFChain records. -3. The TFChain DAO will charge the costs to the user in line with [discount mechanism](../cloud/pricing/staking_discount_levels.md). +3. The TFChain DAO will charge the costs to the user in line with [discount mechanism](cloud@@staking_discount_levels). 4. TFT from the user account are burned/distributed in line to table below. | Percentage | Description | Remark | @@ -37,7 +37,7 @@ Every hour, the utilization is recorded in TFChain and the user is charged for t | 35% | TFT burning | A mechanism used to maintain scarcity in the TFT economy. | | 10% | ThreeFold Foundation | Funds allocated to promote and grow the ThreeFold Grid. | | 5% | Validator Staking Pool | Rewards farmers that run TFChain 3.0 validator nodes. | -| 50% | Solution providers & sales channel | managed by [ThreeFold DAO](../about/dao/dao.md). | +| 50% | Solution providers & sales channel | managed by [ThreeFold DAO](about@@dao). | > Note: While the solution provider program is still active, the plan is to discontinue the program in the near future. We will update the manual as we get more information. We currently do not accept new solution providers. @@ -47,7 +47,7 @@ Every hour, the utilization is recorded in TFChain and the user is charged for t - Each solution provider and sales channel gets registered in TFChain and as such the distribution can be defined and calculated at billing time. - For billing purposes, ThreeFold DAO will check if it is from a known sales channel or solution provider. If yes, then the billing smart contract code will know how to distribute the TFTs. If the channel of solution provider is not known, then the 50% will go to the ThreeFold Foundation. -- For Certified Farming, [ThreeFold Tech](../about/threefold_tech.md) can define the solution & sales channel parameters, these are channels as provided by ThreeFold Tech. +- For Certified Farming, [ThreeFold Tech](about@@threefold_tech) can define the solution & sales channel parameters, these are channels as provided by ThreeFold Tech. - Burning can be lowered to 25% if too many tokens would be burned, ThreeFold DAO consensus needs to be achieved. ### Other Ways TFT are Required diff --git a/collections/system_administrators/advanced/cancel_contracts.md b/collections/system_administrators/advanced/cancel_contracts.md index 7b466a0..efab0ff 100644 --- a/collections/system_administrators/advanced/cancel_contracts.md +++ b/collections/system_administrators/advanced/cancel_contracts.md @@ -15,7 +15,7 @@ We present different methods to delete contracts on the TFGrid. ## Using the Dashboard -To cancel contracts with the Dashboard, consult the [Contracts List](../../dashboard/deploy/your_contracts.md) documentation. +To cancel contracts with the Dashboard, consult the [Contracts List](dashboard@@your_contracts) documentation. ## Using GraphQL and Polkadot UI @@ -31,7 +31,7 @@ query MyQuery { ``` -replace `TWIN_ID` with your twin id. The information should be available on the [Dashboard](../../dashboard/dashboard.md). +replace `TWIN_ID` with your twin id. The information should be available on the [Dashboard](dashboard@@dashboard). Then from [polkadot UI](https://polkadot.js.org/apps/), add the tfchain endpoint to development. diff --git a/collections/system_administrators/advanced/grid3_stellar_tfchain_bridge.md b/collections/system_administrators/advanced/grid3_stellar_tfchain_bridge.md index f74cbdb..11e84da 100644 --- a/collections/system_administrators/advanced/grid3_stellar_tfchain_bridge.md +++ b/collections/system_administrators/advanced/grid3_stellar_tfchain_bridge.md @@ -13,13 +13,13 @@ This document will explain how you can transfer TFT from Tfchain to Stellar and back. -For more information on TFT bridges, read [this documentation](../threefold_token/tft_bridges/tft_bridges.md). +For more information on TFT bridges, read [this documentation](threefold_token@@tft_bridges). ## Prerequisites -- [Stellar wallet](../threefold_token/storing_tft/storing_tft.md) +- [Stellar wallet](threefold_token@@storing_tft) -- [Account on TFChain (use TF Dashboard to create one)](../dashboard/wallet_connector.md) +- [Account on TFChain (use TF Dashboard to create one)](dashboard@@wallet_connector) ![](./img/bridge.png) diff --git a/collections/system_administrators/getstarted/tfgrid3_getstarted.md b/collections/system_administrators/getstarted/tfgrid3_getstarted.md index dcfd756..d7ef097 100644 --- a/collections/system_administrators/getstarted/tfgrid3_getstarted.md +++ b/collections/system_administrators/getstarted/tfgrid3_getstarted.md @@ -4,10 +4,10 @@ It's easy to get started on the TFGrid and deploy applications. -- [Create a TFChain Account](../../dashboard/wallet_connector.md) -- [Get TFT](../../threefold_token/buy_sell_tft/buy_sell_tft.md) -- [Bridge TFT to TChain](../../threefold_token/tft_bridges/tft_bridges.md) -- [Deploy an Application](../../dashboard/deploy/deploy.md) +- [Create a TFChain Account](dashboard@@wallet_connector) +- [Get TFT](threefold_token@@buy_sell_tft) +- [Bridge TFT to TChain](threefold_token@@tft_bridges) +- [Deploy an Application](dashboard@@deploy) - [SSH Remote Connection](./ssh_guide/ssh_guide.md) - [SSH with OpenSSH](./ssh_guide/ssh_openssh.md) - [SSH with PuTTY](./ssh_guide/ssh_putty.md) @@ -16,8 +16,8 @@ It's easy to get started on the TFGrid and deploy applications. ## Grid Platforms -- [TF Dashboard](../../dashboard/dashboard.md) -- [TF Flist Hub](../../developers/flist/flist_hub/zos_hub.md) +- [TF Dashboard](dashboard/dashboard@@) +- [TF Flist Hub](developers@@zos_hub) ## TFGrid Services and Resources diff --git a/collections/system_administrators/getstarted/tfgrid3_what_to_know.md b/collections/system_administrators/getstarted/tfgrid3_what_to_know.md index 300caa1..2a47adf 100644 --- a/collections/system_administrators/getstarted/tfgrid3_what_to_know.md +++ b/collections/system_administrators/getstarted/tfgrid3_what_to_know.md @@ -50,7 +50,7 @@ We leverage the VM primitive to allow provisioning kubernetes clusters across mu ## Exploring the capacity -You can easily check using [explorer-ui](dashboard/explorer/explorer_home.md) , also to plan your deployment you can use these [example queries](dashboard/explorer/explorer_graphql_examples.md) +You can easily check using [explorer-ui](dashboard@@explorer_home) , also to plan your deployment you can use these [example queries](dashboard@@explorer_graphql_examples) ## Getting started diff --git a/collections/system_administrators/gpu/gpu.md b/collections/system_administrators/gpu/gpu.md index 0d85112..96c5112 100644 --- a/collections/system_administrators/gpu/gpu.md +++ b/collections/system_administrators/gpu/gpu.md @@ -25,7 +25,7 @@ To use a GPU on the TFGrid, users need to rent a dedicated node. Once they have ## Filter and Reserve a GPU Node -You can filter and reserve a GPU node using the [Dedicated Nodes section](../../dashboard/deploy/dedicated_machines.md) of the **ThreeFold Dashboard**. +You can filter and reserve a GPU node using the [Dedicated Nodes section](dashboard@@dedicated_machines) of the **ThreeFold Dashboard**. ### Filter Nodes @@ -52,7 +52,7 @@ When you have decided which node to reserve, click on **Reserve** under the colu ## Deploy a VM with GPU -Now that you've reserverd a dedicated GPU node, it's time to deploy a VM to make use of the GPU! There are many ways to proceed. You can use the [Dashboard](../../dashboard/solutions/fullVm.md), [Go](../../developers/go/grid3_go_gpu.md), [Terraform](../terraform/terraform_gpu_support.md), etc. +Now that you've reserverd a dedicated GPU node, it's time to deploy a VM to make use of the GPU! There are many ways to proceed. You can use the [Dashboard](../../dashboard/solutions/fullVm.md), [Go](developers@@grid3_go_gpu), [Terraform](../terraform/terraform_gpu_support.md), etc. For example, deploying a VM with GPU on the Dashboard is easy. Simply set the GPU option and make sure to select your dedicated node, as show here: ![image](./img/gpu_3.png) diff --git a/collections/system_administrators/gpu/gpu_toc.md b/collections/system_administrators/gpu/gpu_toc.md index 073c79e..ea2a846 100644 --- a/collections/system_administrators/gpu/gpu_toc.md +++ b/collections/system_administrators/gpu/gpu_toc.md @@ -7,13 +7,13 @@ Feel free to explore the different possibilities!

Table of Contents

- [GPU Support](./gpu.md) -- [Node Finder and GPU](../../dashboard/deploy/node_finder.md#gpu-support) -- [Javascript Client and GPU](../../developers/javascript/grid3_javascript_gpu_support.md) -- [GPU and Go](../../developers/go/grid3_go_gpu.md) - - [GPU Support](../../developers/go/grid3_go_gpu_support.md) - - [Deploy a VM with GPU](../../developers/go/grid3_go_vm_with_gpu.md) -- [TFCMD and GPU](../../developers/tfcmd/tfcmd_vm.md#deploy-a-vm-with-gpu) +- [Node Finder and GPU](dashboard@@node_finder) +- [Javascript Client and GPU](developers@@grid3_javascript_gpu_support) +- [GPU and Go](developers@@grid3_go_gpu) + - [GPU Support](developers@@grid3_go_gpu_support) + - [Deploy a VM with GPU](developers@@grid3_go_vm_with_gpu) +- [TFCMD and GPU](developers@@tfcmd_vm) - [Terraform and GPU](../terraform/terraform_gpu_support.md) -- [Full VM and GPU](../../dashboard/solutions/fullVm.md) -- [Zero-OS API and GPU](../../developers/internals/zos/manual/api.md#gpus) -- [GPU Farming](../../farmers/3node_building/gpu_farming.md) \ No newline at end of file +- [Full VM and GPU](dashboard@@fullvm) +- [Zero-OS API and GPU](developers@@api) +- [GPU Farming](farmers@@gpu_farming) \ No newline at end of file diff --git a/collections/system_administrators/terraform/advanced/terraform_nextcloud_vpn.md b/collections/system_administrators/terraform/advanced/terraform_nextcloud_vpn.md index 4045078..2eb4ccf 100644 --- a/collections/system_administrators/terraform/advanced/terraform_nextcloud_vpn.md +++ b/collections/system_administrators/terraform/advanced/terraform_nextcloud_vpn.md @@ -263,9 +263,9 @@ Note that, at any moment, if you want to see the information on your Terraform d # Nextcloud Setup * Access Nextcloud Setup - * Once you've deployed Nextcloud, you can access the Nextcloud Setup page by pasting on a browser the URL displayed on the line `fqdn = "..."` of the `terraform show` output. For more information on this, [read this documentation](../../../dashboard/solutions/nextcloud.md#nextcloud-setup). + * Once you've deployed Nextcloud, you can access the Nextcloud Setup page by pasting on a browser the URL displayed on the line `fqdn = "..."` of the `terraform show` output. For more information on this, [read this documentation](dashboard@@nextcloud). * Create a backup and set a daily backup and update - * Make sure to create a backup with `/mnt/backup` as the mount point, and set a daily update and backup for your Nextcloud VM. For more information, [read this documentation](../../../dashboard/solutions/nextcloud.md#backups-and-updates). + * Make sure to create a backup with `/mnt/backup` as the mount point, and set a daily update and backup for your Nextcloud VM. For more information, [read this documentation](dashboard@@nextcloud). > Note: By default, the daily Borgbackup is set at 4:00 UTC. If you change this parameter, make sure to adjust the moment the [Rsync backup](#create-a-cron-job-for-the-rsync-daily-backup) is done. diff --git a/collections/system_administrators/terraform/resources/terraform_vm.md b/collections/system_administrators/terraform/resources/terraform_vm.md index b349c5e..1b88f43 100644 --- a/collections/system_administrators/terraform/resources/terraform_vm.md +++ b/collections/system_administrators/terraform/resources/terraform_vm.md @@ -163,7 +163,7 @@ It's bit long for sure but let's try to dissect it a bit ip_range = lookup(grid_network.net1.nodes_ip_range, 2, "") ``` -- `node = grid_scheduler.sched.nodes["node1"]` means this deployment will happen on node returned from the scheduler. Otherwise the user can specify the node as `node = 2` and in this case the choice of the node is completely up to the user at this point. They need to do the capacity planning. Check the [Node Finder](../../../dashboard/deploy/node_finder.md) to know which nodes fits your deployment criteria. +- `node = grid_scheduler.sched.nodes["node1"]` means this deployment will happen on node returned from the scheduler. Otherwise the user can specify the node as `node = 2` and in this case the choice of the node is completely up to the user at this point. They need to do the capacity planning. Check the [Node Finder](dashboard@@node_finder) to know which nodes fits your deployment criteria. - `network_name` which network to deploy our project on, and here we choose the `name` of network `net1` - `ip_range` here we [lookup](https://www.terraform.io/docs/language/functions/lookup.html) the iprange of node `2` and initially load it with `""` diff --git a/collections/system_administrators/terraform/terraform_basics.md b/collections/system_administrators/terraform/terraform_basics.md index 0d200d6..4102d2a 100644 --- a/collections/system_administrators/terraform/terraform_basics.md +++ b/collections/system_administrators/terraform/terraform_basics.md @@ -51,7 +51,7 @@ There are two options when it comes to finding a node to deploy on. You can use - Use the [scheduler](resources/terraform_scheduler.md) - Scheduler will help you find a node that matches your criteria - Use the Nodes Explorer - - You can check the [Node Finder](../../dashboard/deploy/node_finder.md) to know which nodes fits your deployment criteria. + - You can check the [Node Finder](dashboard@@node_finder) to know which nodes fits your deployment criteria. - Make sure you choose a node which has enough capacity and is available (up and running). ## Preparation @@ -160,7 +160,7 @@ terraform destroy ## Available Flists -You can consult the [list of Flists](../../developers/flist/flist.md) to learn more about the available Flist to use with a virtual machine. +You can consult the [list of Flists](developers@@flist) to learn more about the available Flist to use with a virtual machine. ## Full and Micro Virtual Machines