[Toaster] Review of Toaster manual needed by March 11

[Rifenbark, Scott M]

I have implemented the fixes pointed out by Dave.  I have posted the updated version to the same link so you all have access to the latest.  

http://www.yoctoproject.org/docs/1.8/toaster-manual/toaster-manual.html

Thanks, 
Scott

>-----Original Message-----
>From: Lerner, Dave [mailto:dave.lerner at windriver.com]
>Sent: Friday, March 06, 2015 8:58 AM
>To: Rifenbark, Scott M; Damian, Alexandru; Paul Eggleton; Reyna, David L
>(Wind River); Barros Pena, Belen; Wood, Michael G
>Cc: toaster at yoctoproject.org
>Subject: RE: Review of Toaster manual needed by March 11
>
>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.htm
>> l.  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