diff --git a/getting-started/understanding_spree.md b/getting-started/understanding_spree.md
index 97a424c..37ee2b9 100644
--- a/getting-started/understanding_spree.md
+++ b/getting-started/understanding_spree.md
@@ -41,7 +41,7 @@ Installing Spree via [Spree Starter](https://github.com/spree/spree_starter) giv
 
 --
 
-There are many other Spree-gems providing additional functionality to your Store called [Extensions](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/extensions/README.md).
+There are many other Spree-gems providing additional functionality to your Store called [Extensions](../extensions/extensions.md).
 
 To change which Spree gems you would like to install you will need to modify your project `Gemfile`.
 
diff --git a/internals/stores.md b/internals/stores.md
index 7b52348..f0f28b8 100644
--- a/internals/stores.md
+++ b/internals/stores.md
@@ -51,22 +51,22 @@ Each Store can have different multiple locales and currencies. This configuratio
 
 ## Checkout configuration
 
-Each Store can be configured to ship to only selected countries. This is achieved via the `checkout_zone_id` attribute which holds the ID of the selected [Zone record](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/shipments/README.md#zones).
+Each Store can be configured to ship to only selected countries. This is achieved via the `checkout_zone_id` attribute which holds the ID of the selected [Zone record](shipments.md#zones).
 
-Available Shipping Methods on the Checkout are determined based on the [Zone and Shipping Methods configuration](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/shipments/README.md).
+Available Shipping Methods on the Checkout are determined based on the [Zone and Shipping Methods configuration](shipments.md).
 
-This will also have an effect on what [Shipping / Billing Addresses](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/addresses/README.md) user can add / select during Checkout. Only Addresses from Countries or States available in the selected Zone can be used and will be visible in the User's Address Book.
+This will also have an effect on what [Shipping / Billing Addresses](addresses.md) user can add / select during Checkout. Only Addresses from Countries or States available in the selected Zone can be used and will be visible in the User's Address Book.
 
 ## Store resources
 
 | Resource | Relationship |
 | :--- | :--- |
-| [**Order**](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/orders/README.md) | One Order belongs to one Store |
-| [**Product**](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/products/README.md) | One Product can be associated with many Store\(s\), you can pick and choose in which Store\(s\) each Product will be available |
-| [**Payment Method**](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/payments/README.md#payment-methods) | One Payment Method can be associated with many Store\(s\), you can select in which Stores given Payment Method will be available on Checkout |
+| [**Order**](orders.md) | One Order belongs to one Store |
+| [**Product**](products.md) | One Product can be associated with many Store\(s\), you can pick and choose in which Store\(s\) each Product will be available |
+| [**Payment Method**](payments.md#payment-methods) | One Payment Method can be associated with many Store\(s\), you can select in which Stores given Payment Method will be available on Checkout |
 | **Store Credit** | One Store Credit belongs to and can be used in one Store |
 | **CMS Page** | One Page belongs to one Store |
 | **Navigation Menu** | One Menu belongs to one Store |
-| [**Taxonomy**](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/products/README.md#taxons-and-taxonomies) | One Taxonomy belongs to one Store |
-| [**Promotion**](https://github.com/spree/spree-dev-docs/tree/0628094f68853238d9b13aa3b24d7b1e1b13fca4/internals/promotions/README.md) | One Promotion can be associated with multiple Stores |
+| [**Taxonomy**](products.md#taxons-and-taxonomies) | One Taxonomy belongs to one Store |
+| [**Promotion**](promotions.md) | One Promotion can be associated with multiple Stores |