diff --git a/docs/learn/index.md b/docs/learn/index.md
index f9737c56..bd090ecc 100644
--- a/docs/learn/index.md
+++ b/docs/learn/index.md
@@ -13,12 +13,12 @@ If you're not on Farcaster, get started by [creating your account](https://www.w
 If you want to learn more, get started by diving into these concepts:
 
 - [Farcaster 101](https://www.youtube.com/playlist?list=PL0eq1PLf6eUdm35v_840EGLXkVJDhxhcF) - a walkthrough of the Farcaster protocol in short, 5 minute videos.
-- [Core Concepts](/learn/what-is-farcaster/accounts) - learn about the building blocks of Farcaster, starting with accounts.
-- [Architecture](/learn/architecture/overview) - a breakdown of Farcaster's onchain and offchain systems.
+- [Core Concepts](/learn/what-is-farcaster/accounts.md) - learn about the building blocks of Farcaster, starting with accounts.
+- [Architecture](/learn/architecture/overview.md) - a breakdown of Farcaster's onchain and offchain systems.
 
 ## Tutorials
 
-- [Build your first frame](/developers/frames/getting-started) - Make mini-apps that run inside Farcaster.
+- [Build your first frame](/developers/frames/v2/getting-started.md) - Make mini-apps that run inside Farcaster.
 - [Sign in with Farcaster](/auth-kit/installation) - Let users login to your app with their Farcaster account.
 - [Write your first app](/developers/index) - Publish a "Hello World" message to Farcaster.
 
@@ -27,10 +27,10 @@ Find more how-tos, guide and tutorials like this in the [developers](/developers
 ## Documentation
 
 - [Farcaster Spec](https://github.com/farcasterxyz/protocol) - Specifications for Farcaster, including its contracts and hubs.
-- [Frame Spec](/developers/frames/spec) - Specifications for writing and rendering frames in Farcaster apps.
+- [Frame Spec](/developers/frames/spec.md) - Specifications for writing and rendering frames in Farcaster apps.
 - [APIs](/reference/) - Docs for API's and ABI's for onchain and offchain systems.
 
 ## Contributing
 
 To learn about how to contribute to the protocol, including this documentation site, check out
-the [Contributing](/learn/contributing/overview) section.
+the [Contributing](/learn/contributing/overview.md) section.
diff --git a/docs/reference/fname/api.md b/docs/reference/fname/api.md
index c880b475..a7f8e582 100644
--- a/docs/reference/fname/api.md
+++ b/docs/reference/fname/api.md
@@ -10,7 +10,7 @@ to another fid. Unregistering an fname is a transfer from the user's fid to fid
 ::: warning Registering an fname
 
 Note, when registering a new fname, calling this api is not sufficient. This only reserves the name to your fid. You
-must also submit a [UserDataAdd](/reference/hubble/datatypes/messages#_2-userdata) message to the hub
+must also submit a [UserDataAdd](/docs/reference/hubble/datatypes/messages.md#_2-userdata) message to the hub
 to set this name as your username.
 
 :::