Skip to content

Commit c1000ca

Browse files
authored
infra: move developer-tools to top-level section (#251)
## Summary - Moves `docs/references/developer-tools.md` → `docs/developer-tools/index.md` - Updates sidebar slug from `references/developer-tools` to `developer-tools` (URL: `/developer-tools`) - Patches internal links in `references/index.md`, `guides/ai-coding-agents.md`, `guides/canister-calls/calling-from-clients.md`, and `guides/security/identity-and-access-management.mdx` (the last two links added by PR #253 after this branch was originally created) The page is a navigational toolchain catalogue, not a spec or lookup reference. Its sidebar placement was already top-level (outside the References accordion), but the URL said `/references/developer-tools`. This aligns the URL with the navigational role and opens the section for future sub-pages. ## Sync recommendation `hand-written`
1 parent 48a77bd commit c1000ca

6 files changed

Lines changed: 5 additions & 9 deletions

File tree

File renamed without changes.

docs/guides/ai-coding-agents.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ ICP skills are available without authentication:
9696
## Next steps
9797

9898
- [skills.internetcomputer.org](https://skills.internetcomputer.org): browse all available ICP skills
99-
- [Developer tools](../references/developer-tools.md): icp-cli, CDKs, and other tools in the ICP toolchain
99+
- [Developer tools](../developer-tools/index.md): icp-cli, CDKs, and other tools in the ICP toolchain
100100
- [Quickstart](../getting-started/quickstart.md): deploy your first canister with icp-cli
101101

102102
<!-- Upstream: informed by dfinity/icskills — README.md, skills/*/SKILL.md -->

docs/guides/canister-calls/calling-from-clients.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Crate documentation: [docs.rs/ic-agent](https://docs.rs/ic-agent/latest/ic_agent
6161

6262
### Community agents
6363

64-
Community-maintained agents are available for Go, Java/Android, Dart/Flutter, .NET, Elixir, and C. See [Developer Tools](../../references/developer-tools.md#other-languages) for the full list.
64+
Community-maintained agents are available for Go, Java/Android, Dart/Flutter, .NET, Elixir, and C. See [Developer Tools](../../developer-tools/index.md#other-languages) for the full list.
6565

6666
## JavaScript / TypeScript: using the agent
6767

docs/guides/security/identity-and-access-management.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ Implementing user authentication and canister calls yourself in your web app is
7979

8080
### Recommendation
8181

82-
- Consider using an identity provider such as [Internet Identity](https://github.com/dfinity/internet-identity) for authentication, and use the [ICP JavaScript agent](../../references/developer-tools.md#javascript--typescript) for making canister calls.
82+
- Consider using an identity provider such as [Internet Identity](https://github.com/dfinity/internet-identity) for authentication, and use the [ICP JavaScript agent](../../developer-tools/index.md#javascript--typescript) for making canister calls.
8383

8484
- You may consider alternative authentication frameworks on ICP for authentication.
8585

@@ -99,7 +99,7 @@ The auth-client supports [idle timeouts](https://js.icp.build/auth/latest/api/cl
9999

100100
### Security concern
101101

102-
`agent.fetchRootKey()` can be used in the [ICP JavaScript agent](../../references/developer-tools.md#javascript--typescript) to fetch the root subnet threshold public key from a status call in test environments. This key is used to verify threshold signatures on certified data received through canister update calls. Using this method in a production web app gives an attacker the option to supply their own public key, invalidating all authenticity guarantees of update responses.
102+
`agent.fetchRootKey()` can be used in the [ICP JavaScript agent](../../developer-tools/index.md#javascript--typescript) to fetch the root subnet threshold public key from a status call in test environments. This key is used to verify threshold signatures on certified data received through canister update calls. Using this method in a production web app gives an attacker the option to supply their own public key, invalidating all authenticity guarantees of update responses.
103103

104104
### Recommendation
105105

docs/references/index.md

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,6 @@ sidebar:
77

88
Technical reference material for ICP development. These pages cover exact specifications, canister IDs, costs, and error codes.
99

10-
## Tools
11-
12-
- **[Developer Tools](developer-tools.md)**: icp-cli, CDKs, JS SDK, PocketIC, ICP Ninja, and other toolchain components.
13-
1410
## Canisters
1511

1612
- **[Management Canister](management-canister.md)**: API reference for the IC management canister (`aaaaa-aa`): canister lifecycle, signing, randomness, and more.

sidebar.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -190,7 +190,7 @@ export const sidebar = [
190190
},
191191
],
192192
},
193-
{ slug: "references/developer-tools", label: "Developer tools" },
193+
{ slug: "developer-tools", label: "Developer tools" },
194194
{
195195
label: "References",
196196
collapsed: true,

0 commit comments

Comments
 (0)