[Buildroot] Structure of the Buildroot manual

Thomas De Schampheleire patrickdepinguin at gmail.com
Sun Mar 2 12:13:24 UTC 2014


Hi Thomas,

On Sun, Feb 23, 2014 at 4:13 PM, Thomas Petazzoni
<thomas.petazzoni at free-electrons.com> wrote:
> Hello,
>
> Today I've written a few updates to the Buildroot manual, and I find
> its structure a bit weird.
>
> The "Daily use" section in "Working with Buildroot" is just a random
> list of facts, with no real connection with each other, and the
> difference with "Advanced usage" in "Going further in Buildroot's
> innards" is not really clear. This section "Going further in Buildroot's
> innards" has a first chapter, 6.1 that really talks about Buildroot
> internal, but the biggest part of the section, 6.2, is not at all about
> Buildroot internals. It's much more a set of tips and descriptions of
> slightly advanced features... a bit like the "Daily use" section.
>
> Similarly the "3.2 make tips" section is a random set of facts, which
> could more or less fit into the "3.5 Daily use" section.
>
> I think we have some good content for the Buildroot manual, but the
> structure is somewhat weird. Maybe it's time to refresh its structure,
> after analyzing the information that we have, and in which order it
> should be presented. I'm sure Thomas DS would have a lot of useful
> ideas in this area :-)
>

Just to let you know: I have seen this mail and am adding the topic to
my todo list...

Best regards,
Thomas


More information about the buildroot mailing list