Improved links from user tutorial docs to reference

docs/user/reference/page_admin.rst

@@ -60,18 +60,35 @@ Here you can:
 * *Copy* all plugins and their contents from an existing translation to the
   current one.
 
+.. _structure-content-button:
+
 The *Structure/Content* button
 ==============================
 
+.. figure:: /images/structure-content.png
+   :figwidth: 143
+   :align: right
+
 Allows you to switch between different editing modes (when you're looking at a
 draft only).
 
+.. _publishing-controller:
+
 *Publishing controller*
 =======================
 
 The *Publishing controller* manages the publishing state of your page - options
-are *Publish page now*, for hitherto unpublished pages, and a *Draft/Live*
-switch.
+are *Publish page now* |publish-page-now|, for hitherto unpublished pages, and
+a control to switch to *Draft* |draft| and *Live* |live| views.
+
+.. |publish-page-now| image:: /images/publish-page-now.png
+   :width: 119
+
+.. |draft| image:: /images/draft.png
+   :width: 91
+
+.. |live| image:: /images/live.png
+   :width: 79
 
 The *disclosure triangle*
 =========================
@@ -125,7 +142,7 @@ From left to right, items in the list have:
 * the page's *Title*
 * a *soft-root* indicator (*Cheese* has *soft-root* applied; *Home* is the menu
   root anyway)
-* *language version status* indicators and controls:
+* *language version* indicators and controls:
 
   * *blank*: the translation does not exist; pressing the indicator will open
     its *Basic settings* (in all other cases, hovering will reveal

docs/user/tutorial/create_page_content.rst

@@ -12,21 +12,24 @@ Adding content to a page
 
 Your page is empty of course. We need to add some content to it, by adding a
 *plugin*. In the toolbar, you'll notice that we're in *Content* mode. Change
-that to *Structure* mode.
+that to *Structure* mode, using the :ref:`Structure/Content button
+<structure-content-button>`.
 
 This reveals the *placeholders* available on the page
 
 On any placeholder, click the menu icon on the right side to reveal the list of
 available plugins. In this case, we'll choose the *Text* plugin. Invoking the
 *Text* plugin will open your installed text editor plugin. Enter some text and
-press "Save". When you save the plugin, your plugin will now be displayed
-"inside" the placeholder as shown in this progression of images:
+press **Save**.
+
+When you save the plugin, your plugin will now be displayed
+"inside" the placeholder, as shown.
 
 Previewing a page
 =================
 
-To preview the page, switch back to *Content* mode using the button in the
-toolbar.
+To preview the page, switch back to *Content* mode using the *Structure/Content
+button* in the toolbar.
 
 You can continue editing existing plugins in *Content* mode simply by
 double-clicking the content they present. Try it: double-click on the text you

docs/user/tutorial/publish_page.rst

@@ -7,9 +7,12 @@ Your page is a *draft* - only you can see it. To publish it so that ordinary web
 You'll notice that the toolbar indicates you're now seeing a *Live* view of
 your page. If you want to make further changes:
 
-* switch back to *Draft* mode
-* make further changes in *Structure* or *Content* mode
-* **Publish changes** when you're ready
+* switch back to *Draft* mode, by using the :ref:`Draft/live switch
+  <publishing-controller>`
+* make further changes in *Structure* or *Content* mode using the
+  :ref:`Structure/Content button <structure-content-button>`
+* **Publish changes** when you're ready, using *Page > Publish page* from the
+  toolbar, or the *language version* control in the :ref:`page-list`
 
 Until you publish your changes, you can continue working on the draft without
 affecting the published page.