<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>9667</bug_id>
          
          <creation_ts>2016-05-24 00:29:36 +0000</creation_ts>
          <short_desc>Image types in quick start guide should be appropriate and consistent</short_desc>
          <delta_ts>2016-10-14 19:15:56 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Quick Start</product>
          <component>quick-start</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard>03 Oct 2016: IN PROGRESS REVIEW</status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>2.2 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Henry Bruce">henry.bruce</reporter>
          <assigned_to name="Henry Bruce">henry.bruce</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>randy.macleod</cc>
    
    <cc>richard.purdie</cc>
    
    <cc>srifenbark</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Done (doc changes complete)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>62406</commentid>
    <comment_count>0</comment_count>
    <who name="Henry Bruce">henry.bruce</who>
    <bug_when>2016-05-24 00:29:36 +0000</bug_when>
    <thetext>The quick start guide uses core-image-sato for the qemux86 target and core-image minimal for Minnowboard Max.

core-image-sato is an unfamiliar U/I. The extra build time does not benefit the average user who is likely to open a console and work from there. For MinnowMax core-image-minimal does not build kernel modules so low speed I/O connector is not full operational.

Both targets should should be headless to reflect the majority of IoT platforms and be the same for a consistent experience. A headless target will also force documentation of the qemu &quot;nographic&quot; mode. MinnowMax should have functional low speed I/O.

core-image-base would be a suitable image. Other suggestions welcome.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>62472</commentid>
    <comment_count>1</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2016-05-26 14:49:19 +0000</bug_when>
    <thetext>This is tricky as not everyone using the project is an IoT user and not every user is comfortable with the console.

I think one big obvious improvement would be if sato has the terminal icon on the first desktop screen shown, then anyone wanting a console has an easy way to find it (its currently one screen to the right iirc).

Assigning this to Jussi to see if there are any tweaks we cna make as part of the sato gtk3 transition.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>62497</commentid>
    <comment_count>2</comment_count>
    <who name="Jussi Kukkonen">jku</who>
    <bug_when>2016-05-27 10:17:54 +0000</bug_when>
    <thetext>&gt; I think one big obvious improvement would be if sato has the terminal icon
&gt; on the first desktop screen shown ...

I&apos;ll see if there&apos;s a good solution to this, I agree current default is a bit useless.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>63205</commentid>
    <comment_count>3</comment_count>
    <who name="Jussi Kukkonen">jku</who>
    <bug_when>2016-06-21 16:49:19 +0000</bug_when>
    <thetext>(In reply to comment #1)
&gt; I think one big obvious improvement would be if sato has the terminal icon
&gt; on the first desktop screen shown, then anyone wanting a console has an easy
&gt; way to find it (its currently one screen to the right iirc).

This particular issue should be fixed. 

Do we want to do something more here -- like improve the headless target used for Minnowboard Max if core-image-minimal does not have all the kernel modules?

I&apos;m resetting assignee in any case.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>63357</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-06-27 17:54:13 +0000</bug_when>
    <thetext>Hi, 

So what is the conclusion here?  Right now we use core-image-minimal and core-image-sata.  I like the mix personally.  Let me know though and we can change it.  

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66594</commentid>
    <comment_count>5</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-09-26 16:41:25 +0000</bug_when>
    <thetext>Setting this to NEEDINFO.  I need some conclusion here to move forward. 

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66651</commentid>
    <comment_count>6</comment_count>
    <who name="Henry Bruce">henry.bruce</who>
    <bug_when>2016-09-27 20:28:55 +0000</bug_when>
    <thetext>I still believe that we should offer a simple headless build through core-image-minimal targeting qemu. It offers a much quicker build and avoids the keyboard mapping issues caused by X11 fowarding on MacOS. Developers who have managed to create an OS image should be familiar enough with command line to use a qemu image. We can offer core-image-sato as a GUI option.

As for Minnow Max, what is the rationale for giving instructions to build an image where the majority of functionality on low speed I/O connector is disabled? If we used core-image-base the connector would work. The BSP team agrees with me on this.

If Richard nor Scott still disagree with my proposal, I suggest we close as INVALID.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66803</commentid>
    <comment_count>7</comment_count>
    <who name="Richard Purdie">richard.purdie</who>
    <bug_when>2016-10-03 14:32:15 +0000</bug_when>
    <thetext>core-image-minimal is too minimal to replace sato, it has no ssh server and is missing a ton of other things a developer might want. 

So I do agree we should recommend something else for minnow. core-image-base or core-image-full-cmdline would seem like options.

The -base/-cmdline verses sato is a harder question. Under qemu, we do have graphics. I think making decisions based on X11 forwarding not working in MacOS is a false economy, whilst Henry evidently hits that use case hard I&apos;m not sure the majority of our new users do.

Perhaps we could just give the users a choice in the quickstart between minimal, full-cmdline and sato as examples of what you can do?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>66831</commentid>
    <comment_count>8</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-03 19:02:12 +0000</bug_when>
    <thetext>Thanks, 

I will leave bitbake core-image-sato alone.  Regarding the second part of the example, see step 3 of the second set of build steps within http://www.yoctoproject.org/docs/2.2/yocto-project-qs/yocto-project-qs.html#qs-building-images.  I have suggested some types of images to build and changed the actual build command to use core-image-base.

Let me know if this all works.

Thanks,
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67096</commentid>
    <comment_count>9</comment_count>
    <who name="Henry Bruce">henry.bruce</who>
    <bug_when>2016-10-10 17:26:45 +0000</bug_when>
    <thetext>I agree that we should use core-image-base instead of core-image-minimal. 

Although manual recommends using core-image-base for MinnowMax build, actual command line refers to core-image-minimal. 

Also can we backport this documentation change to krogoth?</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67131</commentid>
    <comment_count>10</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-11 12:45:20 +0000</bug_when>
    <thetext>Henry, 

That was an oversight on my part.  I have fixed it up and published to master (2.2) and back-ported to 2.1.2 (top of korgoth branch).

See the third step of the second build in http://www.yoctoproject.org/docs/2.2/yocto-project-qs/yocto-project-qs.html#qs-building-images and http://www.yoctoproject.org/docs/2.1.2/yocto-project-qs/yocto-project-qs.html#qs-building-images.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67192</commentid>
    <comment_count>11</comment_count>
    <who name="Henry Bruce">henry.bruce</who>
    <bug_when>2016-10-12 21:30:08 +0000</bug_when>
    <thetext>I&apos;ll accept Richard&apos;s decision that core-image-sato is preferable to core-image-base for qemux86 target. 

Marking as resolved.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>67275</commentid>
    <comment_count>12</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2016-10-14 19:15:56 +0000</bug_when>
    <thetext>Turning the doc flag to &quot;done&quot;.

Scott</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>