[oe] Documentation problems
Koen Kooi
koen at dominion.thruhere.net
Mon Nov 28 14:06:30 UTC 2011
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Op 28-11-11 14:36, Philip Balister schreef:
> On 11/28/2011 08:33 AM, Philip Balister wrote:
>> On 11/28/2011 06:16 AM, Otavio Salvador wrote:
>>> On Mon, Nov 28, 2011 at 09:07, Richard Purdie <
>>> richard.purdie at linuxfoundation.org> wrote:
>>>
>>>> Rather than fork off the Yocto docs for OE's needs, it would be
>>>> nice to see if there was a way we could share the documentation.
>>>>
>>>
>>> I fully agree with that.
>>>
>>> The work would be much easier if all that could be shared.
>>>
>>> AFAIK, using docbook it is possible to use macros to expand for
>>> branding and also conditional to output text so this could be done in
>>> a single repository.
>>>
>>
>> We need to be really careful how all the pieces get branded. There is
>> way too much confusion already, without referring people to the "Yocto
>> Instructions" to use OE-core + layers.
>
> Just to be really clear .....
>
> Also, not I am not opposed to a unified documentation set, just that it
> is clear to people what things are called.
I started composing an email listing a lot of the phrases we need to avoid
("yocto builds <foo>"), but I deleted it since previous attempts have been
met with deafening silence. As I said during the GA: an excellent task for
the board.
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (Darwin)
Comment: GPGTools - http://gpgtools.org
iEYEARECAAYFAk7TlWIACgkQMkyGM64RGpGP3QCgqT0MHXqB1XsNLTEq5zHiPTSo
/CUAnR0FpleNrCBkRnDSzA0eLRzGG0bp
=ErdT
-----END PGP SIGNATURE-----
More information about the Openembedded-devel
mailing list