[yocto] Yocto Project Quick Start Feedback

[Darren Hart]

Scott,

I received from first-time-user feedback regarding the quick start page.
I thought it was good stuff that you should here and consider
incorporating into the document.

1) There is too much introduction, education, and Note blocks before
   we get the user going. The quick start is really about getting them
   going as quickly as possible:

   o Package install
   o Download
   o Build

   There are four "pages" of detail before we get to installing
   packages. 6 before we run any Yocto specific commands.

2) It can be confusing about what to download, since we mention the
   Yocto Project Download page (which has a ton of stuff on it) before
   we tell them to download edison with wget.

3) The Note blocks are huge and distracting for the content. Notes
   should probably be light gray on white in a smaller font, rather
   than white on dark gray. They distract from the primary content.

4) There probably is no need to separate "The Linux Distribution" from
   "The Packages". These convey similar information, and consume a lot
   of space doing so.

5) All the information is good, but it would be good to rearrange things
   such that a new user can actually get a "Quick Start". The Notes
   could be real footnotes, and things like the Development Environment
   section should be "Further Reading" rather than "Required Reading"
   for the "Quick Start".

6) As "Further Reading" we should include something like a "Bitbake
   Flashcard" that outlines the common commands:
   -c listtasks
   -c compile -f
   -c cleansstate (so people don't just start off with
                   "rm -rf tmp sstate-cache")
   -e
   -g depexp -u

I think a good goal would be that a user can run the qemu command
without having to scroll passed the initial screen on the Quick Start guide!

Consider:

Yocto Project Quick Start
=========================
Ubuntu Dependencies
-------------------
$ sudo dpkg-reconfigure dash
  Select "No"
$ sudo apt-get install sed wget cvs subversion git-core coreutils \
  unzip texi2html texinfo libsdl1.2-dev docbook-utils gawk \
  python-pysqlite2 diffstat help2man make gcc build-essential \
  g++ desktop-file-utils chrpath libgl1-mesa-dev libglu1-mesa-dev \
  mercurial autoconf automake groff libtool xterm

Fedora Dependencies
-------------------
     $ sudo yum groupinstall "development tools"
     $ sudo yum install python m4 make wget curl ftp hg tar bzip2 gzip \
     unzip python-psyco perl texinfo texi2html diffstat openjade \
     docbook-style-dsssl sed docbook-style-xsl docbook-dtds \
     docbook-utils sed bc eglibc-devel ccache pcre pcre-devel quilt \
     groff linuxdoc-tools patch linuxdoc-tools cmake help2man \
     perl-ExtUtils-MakeMaker tcl-devel gettext chrpath ncurses apr \
     SDL-devel mesa-libGL-devel mesa-libGLU-devel gnome-doc-utils \
     autoconf automake libtool xterm

openSUSE Dependencies
---------------------
     $ sudo zypper install python gcc gcc-c++ libtool \
     subversion git chrpath automake make wget help2man \
     diffstat texinfo mercurial freeglut-devel libSDL-devel

Download and Build
------------------
$ wget
http://downloads.yoctoproject.org/releases/yocto/yocto-1.1/poky-edison-6.0.tar.bz2
$ tar xjf poky-edison-6.0.tar.bz2
$ source poky-edison-6.0/oe-init-build-env edison-6.0-build
$ bitbake -k core-image-sato
$ runqemu qemux86

-- 
Darren Hart
Intel Open Source Technology Center
Yocto Project - Linux Kernel