diff --git a/docs/docs.md b/docs/docs.md
index 6e676808..b2527bb7 100644
--- a/docs/docs.md
+++ b/docs/docs.md
@@ -21,7 +21,7 @@
 ### More questions?
 
 * [Frequently Asked Question](/faq)
-* [Embedding project](/embed)
+* [Embedding project](/share)
 * [Help Translate](/translate)
 * [Release notes](/release-notes)
 
diff --git a/docs/faq.md b/docs/faq.md
index a0cd14ea..74bb5828 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -18,7 +18,7 @@ to reopen your latest project. You can also open previous project stored locally
 
 The project source is also stored in each compiled ``.hex`` file. Drag and drop the ``.hex`` file into the web editor to load the project.
 
-To share your project with others, you can use the [Embed Project...](/embed). 
+To share your project with others, you can use the [Embed Project...](/share). 
 It stores your project in the cloud and creates a URL that you can share with others.
 
 If you are using [Visual Studio Code](/code), all your programs are stored as files on your computer and you can use your favorite source control system as needed.
diff --git a/docs/embed.md b/docs/share.md
similarity index 88%
rename from docs/embed.md
rename to docs/share.md
index 5aafad05..599a6eed 100644
--- a/docs/embed.md
+++ b/docs/share.md
@@ -1,10 +1,10 @@
-# Embed your project
+# Sharing your project
 
 Once you have a cool project, it is possible to save it in the cloud and share it or embed it to your web site.
 
 ### Instructions
 
-* Click on **More..**, **Embed Project...**
+* Click on **More...** then click **Embed Project...**
 * Click on the **Publish** button
 
 The embed dialog will provide you with various options to embed your project in your web site.
@@ -15,13 +15,13 @@ This URL will point to a web page that contains that project.
 
 * see the "happy" project: https://codethemicrobit.com/pyirlbpsei
 
+### Embedding into a blog or web site
+
+* Copy the HTML and paste it into your HTML source.
+
+
 ### ~hint
 
 **Developers:** This page supports OEmbed as well 
 
 ### ~
-
-### Embedding into a blog or web site
-
-* Copy the HTML and paste it into your HTML source.
-