[gnome-continuous-yocto/gnomeostree-3.28-rocko: 6690/8267] dev-manual, ref-manual: Added procedure for Downloads page

[Emmanuele Bassi <ebassi src gnome org>]

commit ed25d7df9cc755cfcbf24e3a83f129ad8e1575e9
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Thu Jun 22 14:05:24 2017 -0700

    dev-manual, ref-manual: Added procedure for Downloads page
    
    Fixes [YOCTO #11630]
    
    Added a new procedure section for using the Downloads page from
    the YP website.
    
    (From yocto-docs rev: 7efb29dfa7a0960710ca7cf3983048f166c6a13f)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/dev-manual/dev-manual-start.xml      |   40 ++++++++++++++++++++
 .../ref-manual/ref-development-environment.xml     |   18 ++++++---
 2 files changed, 52 insertions(+), 6 deletions(-)
---
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index e7049f9..cdb349b 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -356,6 +356,46 @@
         </para>
     </section>
 
+    <section id='using-the-downloads-page'>
+        <title>Using the Downloads Page</title>
+
+        <para>
+            The
+            <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>
+            uses a "Downloads" area from which you can locate and download
+            tarballs of any Yocto Project release.
+            Rather than Git repositories, these files represent snapshot
+            tarballs.
+            <note><title>Tip</title>
+                The recommended method for accessing Yocto Project
+                components is to use Git to clone a repository and work from
+                within that local repository.
+                The procedure in this section exists should you desire a
+                tarball snapshot of any given component.
+            </note>
+            <orderedlist>
+                <listitem><para>
+                    Open The
+                    <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>
+                    in your browser.
+                    </para></listitem>
+                <listitem><para>
+                    Click the "Downloads" tab.
+                    </para></listitem>
+                <listitem><para>
+                    Click the type of files you want (i.e "Build System",
+                    "Tools", or "Board Support Packages (BSPs)".
+                    </para></listitem>
+                <listitem><para>
+                    Locate the release.
+                    </para></listitem>
+                <listitem><para>
+                    Click the download link to get your files.
+                    </para></listitem>
+            </orderedlist>
+        </para>
+    </section>
+
     <section id='cloning-the-poky-repository'>
         <title>Cloning the <filename>poky</filename> Repository</title>
 
diff --git a/documentation/ref-manual/ref-development-environment.xml 
b/documentation/ref-manual/ref-development-environment.xml
index b640f44..6922736 100644
--- a/documentation/ref-manual/ref-development-environment.xml
+++ b/documentation/ref-manual/ref-development-environment.xml
@@ -711,19 +711,25 @@
                 "<ulink url='&YOCTO_DOCS_DEV_URL;#accessing-index-of-releases'>Accessing Index of 
Releases</ulink>"
                 section in the Yocto Project Development Manual.
                 </para></listitem>
-            <listitem><para>
+            <listitem><para id='downloads-page'>
                 <emphasis>"Downloads" page for the
                 <ulink url='&YOCTO_HOME_URL;'>Yocto Project Website</ulink>:
-                </emphasis>
-                Access this page by going to the website and then selecting
-                the "Downloads" tab.
-                This page allows you to download any Yocto Project
-                release or Board Support Package (BSP) in tarball form.
+                </emphasis></para>
+
+                <para role="writernotes">This section will change due to
+                reworking of the YP Website.</para>
+
+                <para>The Yocto Project website includes a "Downloads" tab
+                that allows you to download any Yocto Project
+                release and Board Support Package (BSP) in tarball form.
                 The tarballs are similar to those found in the
                 <ulink url='&YOCTO_DL_URL;/releases/'>Index of /releases:</ulink> area.</para>
 
                 <para>
                 <imagedata fileref="figures/yp-download.png" align="center" width="6in" depth="4in" />
+                For steps on how to use the "Downloads" page, see the
+                "<ulink url='&YOCTO_DOCS_DEV_URL;#using-the-downloads-page'>Using the Downloads Page</ulink>"
+                section in the Yocto Project Development Manual.
                 </para></listitem>
         </itemizedlist>
     </para>