Re: HOW DO I - new one added for EMGD and Crownbay

[jfabernathy <jfabernathy@gmail.com>]

On 02/06/2012 10:59 AM, Darren Hart wrote:
>
> On 02/06/2012 05:00 AM, James Abernathy wrote:
>> On Feb 5, 2012, at 3:19 PM, Darren Hart wrote:
>>
>>>
>>> On 02/05/2012 11:44 AM, James Abernathy wrote:
>>>> On Feb 5, 2012, at 2:19 PM, Darren Hart wrote:
>>>>
>>>>> On 02/04/2012 07:21 AM, jfabernathy wrote:
>>>>>> I just added and EMGD example to the How Do I in the wiki.
>>>>> Jim, really appreciate your work here. For those of us not
>>>>> following quite as closely, please provide links to the pages
>>>>> you update so we don't have to go hunting for them.
>>>>>
>>>> It's the How Do I link on the wiki page:
>>>>
>>>> https://wiki.yoctoproject.org/wiki/How_do_I
>>> I see. This Question heading seems a bit inconsistent with what you
>>> are actually doing. Step 1 of getting EMGD on Crownbay is adding
>>> alsa to MACHINE_FEATURES for a BSP called meta-mymachine?
>>>
>>> This appears to be just trying to get commercial codecs working
>>> with accelerated graphics.
>>>
>>> The reason I raise this, is that while it's good to have these
>>> sorts of "Tactical" guides, if we aren't careful they can dilute
>>> the documentation space and end up confusing users more than they
>>> help. The README for crownbay covers what is necessary to enable
>>> EMGD accelerated graphics. Please consider renaming the title to
>>> someting more consistent with what you're trying accomplish.
>>>
>> Look, I'm not a documentation expert or understand what the project
>> team is trying to accomplish with their documentation or wiki.  A
>> user on the mailing list asked me to summarize what I did to get all
>> the issues resolve related to media acceleration and decoder.  What I
>> put in  the How Do I was a summation of the questions and answers
>> that were in the email thread. I can just as easily email that user
>> the summary, if it's not appropriate for the wiki.
>>
> Please don't take the above as a criticism of the "How Do I" concept, as
> I said at first, I appreciate you doing it - I understand it takes some
> considerable additional time to publish it. The goal is clearly to make
> things easier for others when they attempt what you're doing. I saw
> something in there that might not fit the goal and raised it as a point
> of improvement, that's all.
>
>
>> Please feel free to edit what I put there or remove it.
> I've CC'd Scott R. to review and see if he might care to adjust things a
> bit. I certainly don't want to remove it :)
>
> --
> Darren
>
What I feel is missing from the standard documentation for EMGD v1.10 
integration into the Crownbay BSP is all the "other" stuff you need.  
The README file in the meta-crownbay includes exactly what is needed to 
integrate the EMGD v 1.10 driver.  But generally, after that users will 
have the next level of questions about how do I get video and audio 
media files to play correctly, or test 3D . This is technically not a 
driver integration question, but can be anticipated because you wouldn't 
care about integrating the EMGD driver unless you had media and 3D needs 
in your application/.

Just my thoughts.

Jim A

>> Jim A
>>
>>> -- Darren
>>>
>>>>> I'm interested to see what more was needed for EMGD and
>>>>> Crownbay than is already in the BSP README.
>>>>>
>>>>>> In my opinion, we need to think about breaking this one big
>>>>>> edit up into individual How Do I's.  It would simplify
>>>>>> editing and make getting to the individual How Do I's much
>>>>>> easier and quicker.
>>>>>>
>>>>>> I don't know how to do that, but I think it needs doing.
>>>>>>
>>>>>> Jim A
>>>>>>
>>>>>> _______________________________________________ yocto mailing
>>>>>> list yocto@yoctoproject.org
>>>>>> https://lists.yoctoproject.org/listinfo/yocto
>>>>> -- Darren Hart Intel Open Source Technology Center Yocto
>>>>> Project - Linux Kernel
>>> -- Darren Hart Intel Open Source Technology Center Yocto Project -
>>> Linux Kernel