[Toaster] Review of Toaster manual needed by March 11

[Lerner, Dave]

Hi Scott,

I thought the document was easy to read and clear.  I have a few suggestions/corrections based on previous work with yocto and toaster.  Unfortunately, I don't have the background to contribute to the missing managed build workflow.

Thanks
Dave

================
Section 1.1. add to both lists (build mode and analysis mode)
 * see the recipes/packages that depend on a specific recipe/package
 * see recipes/packages that are required for a specific recipe/package
================

2.2 missing 'is'
In order to make it easy to run Toaster, a requirements file 'is' located in the root directory of Source Directory bitbake/ (e.g. poky/bitbake/toaster-requirements.txt).
================

2.2 optional virtualenv
I don't use virtualenv, since I don't mind changing the system files.  You note that it is  optional which is correct, however you note that *after* the steps that describe virtualenv installation and usage.  Maybe you could modify and move the text as follow?...
-----------
Once you complete the following optional steps, you can execute in a lightweight "virtual environment" with its own site directories that are optionally isolated from system site directories. The virtual environment has its own Python binary (allowing creation of environments with various Python versions) and can have its own independent set of installed Python packages in its site directories.
    Install virtualenv: virtualenv is a tool to create isolated Python environments by creating folders that contain all the necessary executables to use the packages that Python projects need.
    Create and activate a virtual environment:
         $ virtualenv venv
         $ source venv/bin/activate
...
======================

3.1.2 #4 The caveats about sqlite3 may suggest that toaster web browsing can't access the toaster data which is not correct - I do it daily. So I would slightly modify the caveats re sqlite to...
-------------
Another example database server is sqlite3. With this server, you have the advantage of no configuration and an easy installation. Although a toaster web-browser session still has access through the web server hosted with the sqlite database, you do not have direct remote access to the database. Also, sqlite3 is slower as compared to mysql-server, and has no transactional support....

==================
3.1.2 #6
Fix typo: 
TOASTER_MANAGED = Trure

==================

Thanks!
Dave Lerner

> -----Original Message-----
> From: toaster-bounces at yoctoproject.org [mailto:toaster-bounces at yoctoproject.org] On
> Behalf Of Rifenbark, Scott M
> Sent: Wednesday, March 04, 2015 10:29 AM
> To: DAMIAN, ALEXANDRU; Paul Eggleton; Reyna, David; BARROS PENA, BELEN; WOOD, MICHAEL
> Cc: toaster at yoctoproject.org
> Subject: [Toaster] 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
> toaster at yoctoproject.org
> https://lists.yoctoproject.org/listinfo/toaster