[Toaster] Updated version of Toaster manual available

[Reyna, David]

Hi Scott,

Here are my comments:

1) "Belen noted that we need something on the Django administrative interface."

[DLR] I agree that you should suggest or point to existing community documentation and only note the differences. Below is my suggested content.

 * Here is a sample link to information about Django administrative interface.

   https://docs.djangoproject.com/en/1.7/ref/contrib/admin/

[DLR] Here are the Toaster enhancements as I see them:

 * The Toaster will guide you in setting up the initial Django admin account as part of first time startup sequence as described later in the document, and this is sufficient for running Toaster.

 * If desired, the core Toaster settings can be modified in the Django site administration page, which can be accessed via:

  (a) Open the Django admin page with "http://127.0.0.1:8000/admin"
  (b) Enter the admin account and password that you set when you first starter Toaster.

  (c) The "Auth" section is used to manage users and groups.
  (d) The "Bldcontrol" section is used to change the build environment settings, like the source and build directories, plus the default ports.
  (e) The "Toaster settings" section is used to modify the default build configure variables (with the "DEFCONF_" prefixes). You can for example change the existing default values or add new custom variables.


2) 3.1.1, "3. Source your Build Environment Setup Script: From your Build Directory (e.g. poky/build), source the build environment setup script oe-init-build-env or oe-init-build-env-memres."

[DLR] This is wrong. The "oe-init-build-env" will _always_ create a new "build" directory from where you are. If you follow your instructions you will find yourself in a ".../build/build" directory. Here are working sample instructions.

This will leave you in a new and pre-configured "<installdir>/build" directory.

  $ cd <installdir>
  $ source poky/oe-init-build-env


3) 3.1.1, "6. Open Your Browser"

[DLR] I suggest you add the default Toaster path, so that it is easy for the user to immediately use:

  Open your browser and visit http://host:port/toastergui (example "http://127.0.0.1:8000/toastergui").


4) "Belen indicated that we are missing the step where you start the Toaster user interface"

[DLR] I myself do not understand this note.


5) 3.2.1, "Setting Up Locally and Running in Build Mode"

[DLR] Steps #4 to #8 are actually sub-steps of #3 (Start Toaster), in that they. 

I think that they should either be indented to reflect that, or you should insert a note after #3 mentioning the fact that "bitbake/bin/toaster" will prompt the user for the information in the following steps.

- David


> -----Original Message-----
> From: Rifenbark, Scott M [mailto:scott.m.rifenbark at intel.com]
> Sent: Tuesday, March 10, 2015 10:24 AM
> To: DAMIAN, ALEXANDRU; 'Paul Eggleton'; Reyna, David; BARROS PENA, BELEN;
> WOOD, MICHAEL
> Cc: 'toaster at yoctoproject.org'
> Subject: RE: Updated version of Toaster manual available
> 
> New version up that incorporates feedback from Michael Wood.  See
> http://www.yoctoproject.org/docs/1.8/toaster-manual/toaster-manual.html.
> 
> Scott
> 
> >-----Original Message-----
> >From: Rifenbark, Scott M
> >Sent: Monday, March 09, 2015 12:10 PM
> >To: Damian, Alexandru; Paul Eggleton; Reyna, David L (Wind River); Barros
> >Pena, Belen; Wood, Michael G
> >Cc: toaster at yoctoproject.org
> >Subject: Updated version of Toaster manual available
> >
> >Hi,
> >
> >At http://www.yoctoproject.org/docs/1.8/toaster-manual/toaster-
> >manual.html you will always find the latest version of the manual.  At
> this
> >point, I implemented a bunch of feedback from Belen.  I still have more
> of her
> >feedback to put in later during my workday today.  However, I wanted
> >everyone to know that this link has the latest in it.
> >
> >Thanks,
> >Scott
> >
> >>-----Original Message-----
> >>From: Rifenbark, Scott M
> >>Sent: Wednesday, March 04, 2015 8:29 AM
> >>To: Damian, Alexandru; Paul Eggleton; Reyna, David L (Wind River);
> >>Barros Pena, Belen; Wood, Michael G
> >>Cc: toaster at yoctoproject.org
> >>Subject: Review of Toaster manual needed by March 11
> >>
> >>Hi,
> >>
> >>Please have some feedback for the Toaster manual at
> >>http://www.yoctoproject.org/docs/1.8/toaster-manual/toaster-
> >manual.html.
> >>There are missing steps and information that I need.  The deadline for
> >>this review is one week - March 11th.
> >>
> >>Thanks,
> >>Scott
> >>
> >>Scott Rifenbark
> >>Intel Corporation
> >>Yocto Project Documentation
> >>503.712.2702
> >>503.341.0418 (cell)
>