Re: Documentation problems

[Koen Kooi <koen@dominion.thruhere.net>]

-----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@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-----