my idea of a quick start guide

my idea of a quick start guide

[Robert P. J. Day]

  since it's easier to just write something than suggest numerous
fixes, i took less than an hour and wrote this:

http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start

it's the sort of thing that would have been perfect for me when i
first jumped into yocto.

  i'm going to add a couple more short sections but, technically, it
contains everything i would have needed to know to build my first
image.

  thoughts?

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: my idea of a quick start guide

[Rifenbark, Scott M]

Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:

http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user

Feedback and comments welcome.

Scott

-----Original Message-----
From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
Sent: Wednesday, February 29, 2012 10:49 AM
To: Yocto discussion list
Subject: [yocto] my idea of a quick start guide


  since it's easier to just write something than suggest numerous
fixes, i took less than an hour and wrote this:

http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start

it's the sort of thing that would have been perfect for me when i
first jumped into yocto.

  i'm going to add a couple more short sections but, technically, it
contains everything i would have needed to know to build my first
image.

  thoughts?

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================
_______________________________________________
yocto mailing list
yocto@yoctoproject.org
https://lists.yoctoproject.org/listinfo/yocto

Re: my idea of a quick start guide

[Stewart, David C]

I like it.

>-----Original Message-----
>From: yocto-bounces@yoctoproject.org [mailto:yocto-
>bounces@yoctoproject.org] On Behalf Of Rifenbark, Scott M
>Sent: Friday, March 16, 2012 4:28 PM
>To: Robert P. J. Day; Yocto discussion list
>Subject: Re: [yocto] my idea of a quick start guide
>
>Several people have indicated a quick start section like Robert's wiki page
>would be good in the YP QS.  I agree that the idea of diverting the super user
>to a shortened, more concise section that let's you kick the tires of Yocto is a
>good idea.  I have created a section based on Robert's example from his wiki
>page.  You can see it at this link:
>
>http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-
>qs.html#super-user
>
>Feedback and comments welcome.
>
>Scott
>
>-----Original Message-----
>From: yocto-bounces@yoctoproject.org [mailto:yocto-
>bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
>Sent: Wednesday, February 29, 2012 10:49 AM
>To: Yocto discussion list
>Subject: [yocto] my idea of a quick start guide
>
>
>  since it's easier to just write something than suggest numerous
>fixes, i took less than an hour and wrote this:
>
>http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
>
>it's the sort of thing that would have been perfect for me when i
>first jumped into yocto.
>
>  i'm going to add a couple more short sections but, technically, it
>contains everything i would have needed to know to build my first
>image.
>
>  thoughts?
>
>rday
>
>--
>
>===========================================================
>=============
>Robert P. J. Day                                 Ottawa, Ontario, CANADA
>                        http://crashcourse.ca
>
>Twitter:                                       http://twitter.com/rpjday
>LinkedIn:                               http://ca.linkedin.com/in/rpjday
>===========================================================
>=============
>_______________________________________________
>yocto mailing list
>yocto@yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto
>_______________________________________________
>yocto mailing list
>yocto@yoctoproject.org
>https://lists.yoctoproject.org/listinfo/yocto

Re: my idea of a quick start guide

[Robert P. J. Day]

On Fri, 16 Mar 2012, Rifenbark, Scott M wrote:

> Several people have indicated a quick start section like Robert's
> wiki page would be good in the YP QS.  I agree that the idea of
> diverting the super user to a shortened, more concise section that
> let's you kick the tires of Yocto is a good idea.  I have created a
> section based on Robert's example from his wiki page.  You can see
> it at this link:
>
> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
>
> Feedback and comments welcome.
>
> Scott

  i think it was gary thomas who pointed out an even simpler way to
set up premirrors than what you copied from my QS page:

SOURCE_MIRROR_URL ?= "file:///home/rpjday/dl/"
INHERIT += "own-mirrors"
BB_GENERATE_MIRROR_TARBALLS = "1"
# BB_NO_NETWORK = "1"


rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: my idea of a quick start guide

[Darren Hart]

On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
> Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:
> 
> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
> 
> Feedback and comments welcome.

It's not a bad section to have, but it doesn't feel integrated into the
quickstart, especially the bit about building for Beagleboard xM. Users
looking for a truly quick start will still have to troll through pages
of introductory overview and concepts before they get to this. I still
argue that a new user should be able to build and boot qemux86 sato
using the QS guide without having to scroll down.

--
Darren

> 
> Scott
> 
> -----Original Message-----
> From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
> Sent: Wednesday, February 29, 2012 10:49 AM
> To: Yocto discussion list
> Subject: [yocto] my idea of a quick start guide
> 
> 
>   since it's easier to just write something than suggest numerous
> fixes, i took less than an hour and wrote this:
> 
> http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
> 
> it's the sort of thing that would have been perfect for me when i
> first jumped into yocto.
> 
>   i'm going to add a couple more short sections but, technically, it
> contains everything i would have needed to know to build my first
> image.
> 
>   thoughts?
> 
> rday
> 

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

Re: my idea of a quick start guide

[Darren Hart]

Also, the Note and Tip blocks formatting has improved, but I still find
it distracting that the title font for these is still larger than any of
the heading fonts in the rest of the document.

--
Darren

On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
> Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:
> 
> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
> 
> Feedback and comments welcome.
> 
> Scott
> 
> -----Original Message-----
> From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
> Sent: Wednesday, February 29, 2012 10:49 AM
> To: Yocto discussion list
> Subject: [yocto] my idea of a quick start guide
> 
> 
>   since it's easier to just write something than suggest numerous
> fixes, i took less than an hour and wrote this:
> 
> http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
> 
> it's the sort of thing that would have been perfect for me when i
> first jumped into yocto.
> 
>   i'm going to add a couple more short sections but, technically, it
> contains everything i would have needed to know to build my first
> image.
> 
>   thoughts?
> 
> rday
> 

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

Re: my idea of a quick start guide

[Robert P. J. Day]

On Mon, 19 Mar 2012, Darren Hart wrote:

> On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
> > Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:
> >
> > http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
> >
> > Feedback and comments welcome.
>
> It's not a bad section to have, but it doesn't feel integrated into
> the quickstart, especially the bit about building for Beagleboard
> xM. Users looking for a truly quick start will still have to troll
> through pages of introductory overview and concepts before they get
> to this. I still argue that a new user should be able to build and
> boot qemux86 sato using the QS guide without having to scroll down.

  actually, i agree -- i had no input into where that content was
placed in the QS guide. :-)

  in fact, i'm currently in the process of writing some OE-core
tutorial material and part of that involves showing how to build a
QEMU core-image-sato image using nothing but a checkout of oe-core.
so that's not really yocto material, it's much more basic OE-core
material.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================

Re: my idea of a quick start guide

[Rifenbark, Scott M]

I could replace the Beagleboard xM machine with qemux86.  The introductory bit up front provides minimal inconvenience to the reader to quickly hop down to the section via the link.  

Scott

-----Original Message-----
From: Darren Hart [mailto:dvhart@linux.intel.com] 
Sent: Monday, March 19, 2012 11:07 AM
To: Rifenbark, Scott M
Cc: Robert P. J. Day; Yocto discussion list
Subject: Re: [yocto] my idea of a quick start guide



On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
> Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:
> 
> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
> 
> Feedback and comments welcome.

It's not a bad section to have, but it doesn't feel integrated into the
quickstart, especially the bit about building for Beagleboard xM. Users
looking for a truly quick start will still have to troll through pages
of introductory overview and concepts before they get to this. I still
argue that a new user should be able to build and boot qemux86 sato
using the QS guide without having to scroll down.

--
Darren

> 
> Scott
> 
> -----Original Message-----
> From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
> Sent: Wednesday, February 29, 2012 10:49 AM
> To: Yocto discussion list
> Subject: [yocto] my idea of a quick start guide
> 
> 
>   since it's easier to just write something than suggest numerous
> fixes, i took less than an hour and wrote this:
> 
> http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
> 
> it's the sort of thing that would have been perfect for me when i
> first jumped into yocto.
> 
>   i'm going to add a couple more short sections but, technically, it
> contains everything i would have needed to know to build my first
> image.
> 
>   thoughts?
> 
> rday
> 

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

Re: my idea of a quick start guide

[Rifenbark, Scott M]

I find that irritating as well and will try and look into changing that.

Scott

-----Original Message-----
From: Darren Hart [mailto:dvhart@linux.intel.com] 
Sent: Monday, March 19, 2012 11:09 AM
To: Rifenbark, Scott M
Cc: Robert P. J. Day; Yocto discussion list
Subject: Re: [yocto] my idea of a quick start guide

Also, the Note and Tip blocks formatting has improved, but I still find
it distracting that the title font for these is still larger than any of
the heading fonts in the rest of the document.

--
Darren

On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
> Several people have indicated a quick start section like Robert's wiki page would be good in the YP QS.  I agree that the idea of diverting the super user to a shortened, more concise section that let's you kick the tires of Yocto is a good idea.  I have created a section based on Robert's example from his wiki page.  You can see it at this link:
> 
> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
> 
> Feedback and comments welcome.
> 
> Scott
> 
> -----Original Message-----
> From: yocto-bounces@yoctoproject.org [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J. Day
> Sent: Wednesday, February 29, 2012 10:49 AM
> To: Yocto discussion list
> Subject: [yocto] my idea of a quick start guide
> 
> 
>   since it's easier to just write something than suggest numerous
> fixes, i took less than an hour and wrote this:
> 
> http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
> 
> it's the sort of thing that would have been perfect for me when i
> first jumped into yocto.
> 
>   i'm going to add a couple more short sections but, technically, it
> contains everything i would have needed to know to build my first
> image.
> 
>   thoughts?
> 
> rday
> 

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

Re: my idea of a quick start guide

[Darren Hart]

On 03/19/2012 10:17 AM, Rifenbark, Scott M wrote:
> I could replace the Beagleboard xM machine with qemux86.  The
> introductory bit up front provides minimal inconvenience to the

"Minimal inconvenience" is a subjective assessment of course. I find it
very annoying to slog through that much material when all I want are the
3 shell commands to get it going, from which I can typically infer a lot.

Other have reported similar views.

> reader to quickly hop down to the section via the link.

I missed this on my first scan, despite checking for it. My fault? Sure.
But I'm not likely to be the only one.

--
Darren

> 
> Scott
> 
> -----Original Message----- From: Darren Hart
> [mailto:dvhart@linux.intel.com] Sent: Monday, March 19, 2012 11:07
> AM To: Rifenbark, Scott M Cc: Robert P. J. Day; Yocto discussion
> list Subject: Re: [yocto] my idea of a quick start guide
> 
> 
> 
> On 03/16/2012 04:27 PM, Rifenbark, Scott M wrote:
>> Several people have indicated a quick start section like Robert's
>> wiki page would be good in the YP QS.  I agree that the idea of
>> diverting the super user to a shortened, more concise section that
>> let's you kick the tires of Yocto is a good idea.  I have created a
>> section based on Robert's example from his wiki page.  You can see
>> it at this link:
>> 
>> http://www.yoctoproject.org/docs/latest/yocto-project-qs/yocto-project-qs.html#super-user
>>
>>
>> 
Feedback and comments welcome.
> 
> It's not a bad section to have, but it doesn't feel integrated into
> the quickstart, especially the bit about building for Beagleboard xM.
> Users looking for a truly quick start will still have to troll
> through pages of introductory overview and concepts before they get
> to this. I still argue that a new user should be able to build and
> boot qemux86 sato using the QS guide without having to scroll down.
> 
> -- Darren
> 
>> 
>> Scott
>> 
>> -----Original Message----- From: yocto-bounces@yoctoproject.org
>> [mailto:yocto-bounces@yoctoproject.org] On Behalf Of Robert P. J.
>> Day Sent: Wednesday, February 29, 2012 10:49 AM To: Yocto
>> discussion list Subject: [yocto] my idea of a quick start guide
>> 
>> 
>> since it's easier to just write something than suggest numerous 
>> fixes, i took less than an hour and wrote this:
>> 
>> http://www.crashcourse.ca/wiki/index.php/Yocto_Project_Quick_Start
>> 
>> it's the sort of thing that would have been perfect for me when i 
>> first jumped into yocto.
>> 
>> i'm going to add a couple more short sections but, technically, it 
>> contains everything i would have needed to know to build my first 
>> image.
>> 
>> thoughts?
>> 
>> rday
>> 
> 

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