Re: [RFC] Create a Release Notes document

[Steven Grunza <steven.grunza@gmail.com>]

On 4/15/2013 9:16 AM, Otavio Salvador wrote:
> Hello,
>
>
> As our community BSP is growing the need for more documentation is
> also getting more important so I’d like to propose the creation of a
> Release Notes document.
>
>
> The idea is it to create it colaboratively, so people who wants to
> help, can contribute to its creation and be an active part of it. My
> proposed strucuture of the document would be the following:
>
>
> SUMARY
>
>      Index
>      Introduction
>      BSP scope
>          meta-fsl-arm
>          meta-fsl-arm-extra
>      Supported machines
>      Hardware acceleration
>           GPU
>           VPU/IPU
>      Know issues
>            …
>
> What your thoguhts about all this? Do you want to be part of it?
>
> Regards,
>
> --
> Otavio Salvador                             O.S. Systems
> E-mail: otavio@ossystems.com.br  http://www.ossystems.com.br
> Mobile: +55 53 9981-7854              http://projetos.ossystems.com.br
> _______________________________________________
> meta-freescale mailing list
> meta-freescale@yoctoproject.org
> https://lists.yoctoproject.org/listinfo/meta-freescale
>
>
Perhaps it's just my extreme newness to git but I would find a section 
with directions on how to go from a completely empty directory to a 
finished build quite useful.  I always seem to have problems with being 
on the wrong branch and when I reach out for help I get instructions to 
"use the correct branch" but no info on how to switch to the correct 
branch.  Reading the man pages is important but there are sometimes 
things that just can't be figured out from man pages.