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:[email protected]]
> Sent: Tuesday, March 10, 2015 10:24 AM
> To: DAMIAN, ALEXANDRU; 'Paul Eggleton'; Reyna, David; BARROS PENA, BELEN;
> WOOD, MICHAEL
> Cc: '[email protected]'
> 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: [email protected]
> >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: [email protected]
> >>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)
> 

-- 
_______________________________________________
toaster mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/toaster

Reply via email to