[gnome-continuous-yocto/gnomeostree-3.28-rocko: 6686/8267] dev-manual, ref-manual: New section on viewing GUI YP repositories

[Emmanuele Bassi <ebassi src gnome org>]

commit 8ee16983cb3545ca2f5f748cc8e5b3083631d70a
Author: Scott Rifenbark <srifenbark gmail com>
Date:   Thu Jun 22 09:19:24 2017 -0700

    dev-manual, ref-manual: New section on viewing GUI YP repositories
    
    Fixes [YOCTO #11630]
    
    I created a new procedure for locating and viewing YP source
    repositories using the GUI-based method.  Created an anchor in the
    ref-manual so I could reference the 'git clone' command.
    
    (From yocto-docs rev: 2ae28682407039420f4fcca71a298e1dd34c81f0)
    
    Signed-off-by: Scott Rifenbark <srifenbark gmail com>
    Signed-off-by: Richard Purdie <richard purdie linuxfoundation org>

 documentation/dev-manual/dev-manual-start.xml      |   54 ++++++++++++++++++--
 .../ref-manual/ref-development-environment.xml     |    2 +-
 2 files changed, 50 insertions(+), 6 deletions(-)
---
diff --git a/documentation/dev-manual/dev-manual-start.xml b/documentation/dev-manual/dev-manual-start.xml
index b0412a5..48f49e0 100644
--- a/documentation/dev-manual/dev-manual-start.xml
+++ b/documentation/dev-manual/dev-manual-start.xml
@@ -253,14 +253,58 @@
         This section contains procedures related to locating and securing
         Yocto Project files.
         You establish and use these local files to work on projects.
-        <note>
-            For concepts and introductory information about Git as it is used
-            in the Yocto Project, see the
-            "<ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink>"
-            section in the Yocto Project Reference Manual.
+        <note><title>Notes</title>
+            <itemizedlist>
+                <listitem><para>
+                    For concepts and introductory information about Git as it
+                    is used in the Yocto Project, see the
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#git'>Git</ulink>"
+                    section in the Yocto Project Reference Manual.
+                    </para></listitem>
+                <listitem><para>
+                    For concepts on Yocto Project source repositories, see the
+                    "<ulink url='&YOCTO_DOCS_REF_URL;#yocto-project-repositories'>Yocto Project Source 
Repositories</ulink>"
+                    section in the Yocto Project Reference Manual."
+                    </para></listitem>
+            </itemizedlist>
         </note>
     </para>
 
+    <section id='viewing-source-repositories-using-your-browser'>
+        <title>Viewing Source Repositories Using Your Browser</title>
+
+        <para>
+            Yocto Project maintains upstream Git
+            <ulink url='&YOCTO_DOCS_REF_URL;#source-repositories'>Source Repositories</ulink>
+            that you can examine using a browser-based UI:
+            <orderedlist>
+                <listitem><para>
+                    Open a browser and go to
+                    <ulink url='&YOCTO_GIT_URL;'></ulink> to access the
+                    GUI-based interface into the Yocto Project source
+                    repositories.
+                    </para></listitem>
+                <listitem><para>
+                    Click on any repository in which you are interested (e.g.
+                    <filename>poky</filename>).
+                    </para></listitem>
+                <listitem><para>
+                    At the bottom of the page, note the URL used to
+                    <ulink url='&YOCTO_DOCS_REF_URL;#git-commands-clone'>clone</ulink>
+                    that repository (e.g.
+                    <filename>&YOCTO_GIT_URL;/poky</filename>).
+                    </para></listitem>
+                <listitem><para>
+                    At the top of the page, click on any branch in which you
+                    might be interested (e.g.
+                    <filename>&DISTRO_NAME_NO_CAP;</filename>).
+                    You can then view the commit log or tree view for that
+                    development branch.
+                    </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 01b0d41..09f097c 100644
--- a/documentation/ref-manual/ref-development-environment.xml
+++ b/documentation/ref-manual/ref-development-environment.xml
@@ -494,7 +494,7 @@
                     You cannot use Git commands unless you have a
                     <filename>.git</filename> repository.
                     </para></listitem>
-                <listitem><para>
+                <listitem><para id='git-commands-clone'>
                     <emphasis><filename>git clone</filename>:</emphasis>
                     Creates a local clone of a Git repository that is on
                     equal footing with a fellow developer’s Git repository