[Toaster] Changes to the Toaster manual

[Scott Rifenbark]

This typo is fixed. See the manual at
file:///home/scottrif/yocto-docs/documentation/toaster-manual/toaster-manual.html#toaster-creating-a-django-super-user

Scott

On Wed, Oct 21, 2015 at 5:54 AM, Barros Pena, Belen <
belen.barros.pena at intel.com> wrote:

> Sorry Scott: just spotted a typo in section 3.5. Where it says
>
> ./bitbake/bin/toaster/manage.py createsuperuser
>
>
> It should say
>
> ./bitbake/lib/toaster/manage.py createsuperuser
>

Fixed.



>
>
> Thanks!
>
> Belén
>
> On 21/10/2015 10:44, "Barros Pena, Belen" <belen.barros.pena at intel.com>
> wrote:
>
> >
> >
> >On 20/10/2015 20:06, "Scott Rifenbark" <srifenbark at gmail.com> wrote:
> >
> >>Hi,
> >>
> >>
> >>I got the chapter 3 changes roughed in.  Can't get to the small chapter
> 2
>
>>change until later.  Here is the link to review the chapter 3 stuff -
> >>
> >>
> http://www.yoctoproject.org/docs/2.0/toaster-manual/toaster-manual.html#t
> >>o
> >>aster-manual-setup-and-use
> >><
> http://www.yoctoproject.org/docs/2.0/toaster-manual/toaster-manual.html#
> >>t
> >>oaster-manual-setup-and-use>.
> >
> >Thanks for this, Scott. Just a few omments:
> >
> >* "(e.g. "Build Mode")," > this is not an example, it is one of the
> >operational modes explained in 1.1. Toaster Operational Modes. We don't
> >have an anchor to the build mode within that 1.1. Section, but if we could
> >split it and create one, that 'build mode' string should be a link to the
> >explanation of the build mode in the operational modes section.
> >
> >* "to the root of your Toaster source directory:" > I don't think it
> >should say the 'Toaster source directory'. People didn't clone Toaster:
> >they cloned / downloaded the 2.0 Yocto Project release. That's the source
> >directory they need to navigate to. Maybe we should just use "navigate to
> >the root of your source directory", which you use further down.
> >
> >* "If you would rather configure and start your builds using the command
> >line" > maybe we should add here "analysis mode" and link it to the
> >corresponding explanation in the toaster operational modes section
> >
> >* Section 3.3 > I think I am missing something. I don't understand what
> >"execute path_to_poky/bitbake/bin/toaster" is supposed to mean. Maybe
> >Brian can explain (he wrote that bit). Also, I think the path is wrong.
> >The _toaster_clones directory is created inside poky
> >(poky/_toaster_clones) not inside
> >poky/bitbake/bin/toaster/_toaster_clones. It also says "if you used the
> >following command to start Toaster", but then no command is shown. Are we
> >missing the path_to_poky/bitbake/bin/toaster command here?
> >
> >* Section 3.4 > all the above also applies to this section. The build
> >directory is inside poky (poky/build) not poky/bitbake/bin/toaster/build.
> >We are also missing the command you need to execute:
> >path_to_poky/bitbake/bin/toaster
> >
> >* You can use the Django administration interface to set Toaster
> >configuration parameters such as the build directory, layer sources,
> >default variable values, and BitBake versions. > we need to test this. It
> >used to be the case, but I am not sure what's happening now after the set
> >up changes made by Brian
> >
> >* to set up Toaster in Build Mode > this should again link to the
> >explanation of the build mode in the operational modes section
> >
> >* Section 3.6.1 > the commands shown for Ubuntu and Fedora make sure you
> >comply with the apache, mod-wsgi and mysql requirements state above, but
> >that is not explicit from the layout.
> >
> >* # change for any release name required > Only jethro and fido will
> >support this kind of set up, I think, so maybe we should remove that
> >sentence
> >
> >* Make sure you make this edit further down in the file from where
> >BUILD_MODE is set based on the TOASTER_MANAGED environment variable > I am
> >not sure I understand this sentence. Does it mean that I have to add
> >BUILD_MODE after TOASTER_MANAGED in the file?
> >
> >* Get Toaster to create the database schema, default data, and gather the
> >statically-served files: > should we break down the steps here to explain
> >what each line does? Those are not obvious for people outside
> >toaster-land.
> >
> >* Here are the commands: > I am not sure what those commands are for. Can
> >we explain?
> >
> >>
> >>
> >>Note that I left the section in on using the web interface.  I am
> >>assuming that stuff stays.
> >
> >Yes, although I'd like to list one more video if possible, about building
> >custom layers with Toaster. The video is here:
> >
> >https://www.youtube.com/watch?v=QJzaE_XjX5c
> >
> >
> >Thanks!
> >
> >Belén
> >
> >>
> >>
> >>Let me know of any changes by using this email thread.
> >>
> >>
> >>Thanks,
> >>
> >>Scott
> >>
> >>
> >>On Mon, Oct 19, 2015 at 4:09 AM, Barros Pena, Belen
> >><belen.barros.pena at intel.com> wrote:
> >>
> >>I have gone through the list of changes we put together for the Toaster
> >>manual, and most of them are already there. There is only one thing
> >>pending: changing Chapter 3, the one about setting up and using Toaster.
> >>
> >>The team has put together some new content for that section as a starting
> >>point. It's here
> >>
> >>http://piratepad.nl/YzSI38RuYd
> >>
> >>Note that it includes also some changes for section 2.1 (at the very
> >>top).
> >>
> >>There are 2 gaps in this new content:
> >>
> >>1. How to change the default location of the layers checkout directory
> >>2. How to change the default location of the build directory
> >>
> >>Brian: do you think you could add the above missing information to the
> >>pad, so that Scott can make the changes to the manual (if he has time)?
> >>
> >>Thanks!
> >>
> >>Belén
> >>
> >>
> >>
> >>
> >>
> >>
> >
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.yoctoproject.org/pipermail/toaster/attachments/20151021/82968d61/attachment-0001.html>