docs: AK-194: Updated dev portal links (#615)

larkiny · lempira · web-flow · commit 52bb5191fd71 · 2025-03-25T23:58:01.000+01:00
* AK-194: Updated dev portal links

* Fixed remaining links

* Updated links

* chore: updated docs

* fix: updated test snapshot

---------

Co-authored-by: David Rojas &lt;lempira@gmail.com&gt;
diff --git a/README.md b/README.md
@@ -4,9 +4,9 @@
 
 <p align="center">
     <a target="_blank" href="https://github.com/algorandfoundation/algokit-cli/blob/main/docs/algokit.md"><img src="https://img.shields.io/badge/docs-repository-00dc94?logo=github&style=flat.svg" /></a>
-    <a target="_blank" href="https://developer.algorand.org/algokit/"><img src="https://img.shields.io/badge/learn-AlgoKit-00dc94?logo=algorand&mac=flat.svg" /></a>
+    <a target="_blank" href="https://dev.algorand.co/algokit/algokit-intro"><img src="https://img.shields.io/badge/learn-AlgoKit-00dc94?logo=algorand&mac=flat.svg" /></a>
     <a target="_blank" href="https://github.com/algorandfoundation/algokit-cli"><img src="https://img.shields.io/github/stars/algorandfoundation/algokit-cli?color=00dc94&logo=star&style=flat" /></a>
-    <a target="_blank" href="https://developer.algorand.org/algokit/"><img  src="https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Falgorandfoundation%2Falgokit-cli&countColor=%2300dc94&style=flat" /></a>
+    <a target="_blank" href="https://dev.algorand.co/algokit/algokit-intro"><img  src="https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Falgorandfoundation%2Falgokit-cli&countColor=%2300dc94&style=flat" /></a>
 </p>
 
 ---
@@ -27,7 +27,7 @@ AlgoKit can help you [**learn**](#learn), [**develop**](#develop) and [**operate
 
 ### Learn
 
-There are many learning resources on the [Algorand Developer Portal](https://developer.algorand.org/) and the [AlgoKit landing page](https://developer.algorand.org/algokit) has a range of links to more learning materials. In particular, check out the [quick start tutorial](https://developer.algorand.org/docs/get-started/algokit/) and the [AlgoKit detailed docs page](https://developer.algorand.org/docs/get-details/algokit/).
+There are many learning resources on the [Algorand Developer Portal](https://dev.algorand.co/) and the [AlgoKit landing page](https://dev.algorand.co/algokit/algokit-intro) has a range of links to more learning materials. In particular, check out the [quick start tutorial](https://dev.algorand.co/getting-started/algokit-quick-start/).
 
 If you need help you can access both the [Algorand Discord](https://discord.gg/84AActu3at) (pro-tip: check out the algokit channel!) and the [Algorand Forum](https://forum.algorand.org/).
 
@@ -45,7 +45,7 @@ AlgoKit helps you develop Algorand solutions:
   - [**AlgoKit Templates**](https://github.com/algorandfoundation/algokit-cli/blob/main/docs/features/init.md): Template libraries to get you started faster and quickly set up a productive dev experience
 - **Development**: AlgoKit provides SDKs, tools and libraries that help you quickly and effectively build high quality Algorand solutions:
   - **AlgoKit Utils** ([Python](https://github.com/algorandfoundation/algokit-utils-py#readme) | [TypeScript](https://github.com/algorandfoundation/algokit-utils-ts#readme)): A set of utility libraries so you can develop, test, build and deploy Algorand solutions quickly and easily
-    - [algosdk](https://developer.algorand.org/docs/sdks/) ([Python](https://github.com/algorand/py-algorand-sdk#readme) | [TypeScript](https://github.com/algorand/js-algorand-sdk#readme)) - The core Algorand SDK providing Algorand protocol API calls, which AlgoKit Utils wraps, but still exposes for advanced scenarios
+    - [Algorand SDKs](https://dev.algorand.co/reference/sdks/sdk-list/) - The core Algorand SDK providing Algorand protocol API calls, which AlgoKit Utils wraps, but still exposes for advanced scenarios
   - [**Algorand Python**](https://github.com/algorandfoundation/puya): A semantically and syntactically compatible, typed Python language that works with standard Python tooling and allows you to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM).
   - [**Algorand TypeScript (Beta)**](https://github.com/algorandfoundation/puya-ts): A semantically and syntactically compatible, typed TypeScript language that works with standard TypeScript tooling and allows you to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM). This language is currently in beta.
   - [**TEALScript**](https://github.com/algorandfoundation/TEALScript): A subset of TypeScript that can be used to express smart contracts (apps) and smart signatures (logic signatures) for deployment on the Algorand Virtual Machine (AVM).
diff --git a/docs/cli/index.md b/docs/cli/index.md
@@ -616,7 +616,7 @@ Required argument
 
 Run the Algorand goal CLI against the AlgoKit LocalNet.
 
-Look at [https://developer.algorand.org/docs/clis/goal/goal/](https://developer.algorand.org/docs/clis/goal/goal/) for more information.
+Look at [https://dev.algorand.co/algokit/algokit-cli/goal](https://dev.algorand.co/algokit/algokit-cli/goal) for more information.
 
 ```shell
 algokit goal [OPTIONS] [GOAL_ARGS]...
diff --git a/docs/features/goal.md b/docs/features/goal.md
@@ -1,6 +1,6 @@
 # AlgoKit goal
 
-AlgoKit goal command provides the user with a mechanism to run [goal cli](https://developer.algorand.org/docs/clis/goal/goal/) commands against the current [AlgoKit LocalNet](./localnet.md).
+AlgoKit goal command provides the user with a mechanism to run [goal cli](https://dev.algorand.co/algokit/algokit-cli/goal/) commands against the current [AlgoKit LocalNet](./localnet.md).
 
 You can explore all possible goal commands by running `algokit goal` e.g.:
 
diff --git a/docs/features/localnet.md b/docs/features/localnet.md
@@ -68,13 +68,13 @@ Once they have downloaded, it won't try and re-download images unless you perfor
 
 Once the LocalNet has started, the following endpoints will be available:
 
-- [algod](https://developer.algorand.org/docs/rest-apis/algod/v2/):
+- [algod](https://dev.algorand.co/reference/rest-apis/algod/):
   - address: <http://localhost:4001>
   - token: `aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa`
-- [kmd](https://developer.algorand.org/docs/rest-apis/kmd/):
+- [kmd](https://dev.algorand.co/reference/rest-apis/kmd/):
   - address: <http://localhost:4002>
   - token: `aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa`
-- [indexer](https://developer.algorand.org/docs/rest-apis/indexer/):
+- [indexer](https://dev.algorand.co/reference/rest-apis/indexer/):
   - address: <http://localhost:8980>
 - tealdbg port:
   - address: <http://localhost:9392>
diff --git a/docs/features/tasks/analyze.md b/docs/features/tasks/analyze.md
@@ -30,4 +30,4 @@ This command will recursively analyze all TEAL files in the `contracts` director
 
 ## Security considerations
 
-This task uses [`tealer`](https://github.com/crytic/tealer), a third-party tool, to suggest improvements for your TEAL programs, but remember to always test your smart contracts code, follow modern software engineering practices and use the [guidelines for smart contract development](https://developer.algorand.org/docs/get-details/dapps/smart-contracts/guidelines/). This should not be used as a substitute for an actual audit.
+This task uses [`tealer`](https://github.com/crytic/tealer), a third-party tool, to suggest improvements for your TEAL programs, but remember to always test your smart contracts code, follow modern software engineering practices and use the [guidelines for smart contract development](https://dev.algorand.co/docs/concepts/smart-contracts/overview/). This should not be used as a substitute for an actual audit.
diff --git a/docs/features/tasks/send.md b/docs/features/tasks/send.md
@@ -53,7 +53,7 @@ If the transaction is successfully sent, the transaction ID (txid) will be outpu
 
 ## Goal Compatibility
 
-Please note, at the moment this feature only supports [`goal clerk`](https://developer.algorand.org/docs/clis/goal/clerk/clerk/) compatible transaction objects.
+Please note, at the moment this feature only supports [`goal clerk`](https://dev.algorand.co/algokit/algokit-cli/goal/) compatible transaction objects.
 
 ## Further Reading
 
diff --git a/docs/features/tasks/sign.md b/docs/features/tasks/sign.md
@@ -55,7 +55,7 @@ This will write the signed transaction to the specified file.
 
 ## Goal Compatibility
 
-Please note, at the moment this feature only supports [`goal clerk`](https://developer.algorand.org/docs/clis/goal/clerk/clerk/) compatible transaction objects.
+Please note, at the moment this feature only supports [`goal clerk`](https://dev.algorand.co/algokit/algokit-cli/goal/) compatible transaction objects.
 
 When `--output` option is not specified, the signed transaction(s) will be output to the console in a following JSON format:
 
diff --git a/docs/tutorials/intro.md b/docs/tutorials/intro.md
@@ -129,14 +129,14 @@ Once the `Algorand Python` based project is created, you can get started by buil
 The App ID of the deployed contract and its Algorand address is displayed, followed by the message returned from the smart contract call (`Hello, Python`).
 
 1. Start LocalNet
-2. Build the smart contract. Notice how a folder named `artifacts` is created with the [AVM (Algorand Virtual Machine)](https://developer.algorand.org/docs/get-details/dapps/avm/) related artifacts for deploying your smart contract.
+2. Build the smart contract. Notice how a folder named `artifacts` is created with the [AVM (Algorand Virtual Machine)](https://dev.algorand.co/concepts/smart-contracts/avm/) related artifacts for deploying your smart contract.
 3. Deploy and call the `HelloWorld` smart contract (from `contract.py` file).
 
 After execution, the `App ID` of the deployed contract and its Algorand address are displayed, followed by the message returned from the smart contract call (`Hello, world`).
 
 At this point you have deployed a simple contract to a LocalNet Algorand network (running in your Docker environment) and called it successfully!
 
-Additionally, you can find the native AVM related artifacts and the appropriate smart contract manifest JSON files have been output to the `artifacts` folder. Note that in this example, AVM bytecode is compiled using the `PuyaPy` compiler, which is what `Algorand Python` relies on to compile your Python smart contract code to TEAL ([Transaction Execution Approval Language](https://developer.algorand.org/docs/get-details/dapps/avm/teal/)).
+Additionally, you can find the native AVM related artifacts and the appropriate smart contract manifest JSON files have been output to the `artifacts` folder. Note that in this example, AVM bytecode is compiled using the `PuyaPy` compiler, which is what `Algorand Python` relies on to compile your Python smart contract code to TEAL ([Transaction Execution Approval Language](https://dev.algorand.co/concepts/smart-contracts/languages/teal)).
 
 ### Using AlgoKit CLI to build and deploy contracts 🛠️
 
@@ -168,4 +168,4 @@ We have only covered a tiny fraction of the capabilities of the AlgoKit CLI and
 - To learn more about the commands demonstrated in this tutorial, refer to [`init`](../features/init.md) and [`project`](../features/project.md) to get a comprehensive understanding of their further capabilities.
 - If you'd like to learn more on structuring your `AlgoKit Project` as a monorepo, refer to `workspace` mode as described in [`init`](../features/init.md#workspaces-vs-standalone-projects). You can also pass the `--no-workspace` flag to setup a standalone algokit project, if preferred.
 - If you'd like to **create your own** `AlgoKit` template, refer to the [template tutorial](./algokit-template.md).
-- More information on Algorand smart contracts is also available in the [smart contract documentation](https://developer.algorand.org/docs/get-details/dapps/smart-contracts/).
+- More information on Algorand smart contracts is also available in the [smart contract documentation](https://dev.algorand.co/concepts/smart-contracts/overview).
diff --git a/src/algokit/cli/goal.py b/src/algokit/cli/goal.py
@@ -39,7 +39,7 @@ def goal_command(*, console: bool, interactive: bool, goal_args: list[str]) -> N
     """
     Run the Algorand goal CLI against the AlgoKit LocalNet.
 
-    Look at https://developer.algorand.org/docs/clis/goal/goal/ for more information.
+    Look at https://dev.algorand.co/algokit/algokit-cli/goal for more information.
     """
     goal_args = list(goal_args)
     container_engine = get_container_engine()
diff --git a/tests/goal/test_goal.test_goal_help.approved.txt b/tests/goal/test_goal.test_goal_help.approved.txt
@@ -2,8 +2,7 @@ Usage: algokit goal [OPTIONS] [GOAL_ARGS]...
 
   Run the Algorand goal CLI against the AlgoKit LocalNet.
 
-  Look at https://developer.algorand.org/docs/clis/goal/goal/ for more
-  information.
+  Look at https://dev.algorand.co/algokit/algokit-cli/goal for more information.
 
 Options:
   --console      Open a Bash console so you can execute multiple goal commands

Original file line number	Diff line number	Diff line change
@@ -30,4 +30,4 @@ This command will recursively analyze all TEAL files in the `contracts` director
`30`	`30`
`31`	`31`	`## Security considerations`
`32`	`32`
`33`		-This task uses [`tealer`](https://github.com/crytic/tealer), a third-party tool, to suggest improvements for your TEAL programs, but remember to always test your smart contracts code, follow modern software engineering practices and use the [guidelines for smart contract development](https://developer.algorand.org/docs/get-details/dapps/smart-contracts/guidelines/). This should not be used as a substitute for an actual audit.
	`33`	+This task uses [`tealer`](https://github.com/crytic/tealer), a third-party tool, to suggest improvements for your TEAL programs, but remember to always test your smart contracts code, follow modern software engineering practices and use the [guidelines for smart contract development](https://dev.algorand.co/docs/concepts/smart-contracts/overview/). This should not be used as a substitute for an actual audit.