[Documentation][RFC 1/3] RN: Add pointer to kernel linux section

[Documentation][RFC 1/3] RN: Add pointer to kernel linux section

[Daiane Angolini]

Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
---
 release-notes/source/kernel-linux.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/release-notes/source/kernel-linux.rst b/release-notes/source/kernel-linux.rst
index 717ba2c..21acb65 100644
--- a/release-notes/source/kernel-linux.rst
+++ b/release-notes/source/kernel-linux.rst
@@ -1,3 +1,5 @@
+.. _linux-providers:
+
 Linux Kernel
 ============
 
-- 
1.8.3.2

[Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Daiane Angolini]

The Release Notes for the kernel is out of scope of this RN.

Please, help me to add the better pointer for release notes
out of scope of FSL Community BSP but important for
development, such as kernel release notes for linux providers
others that linux-imx.

Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
---
 release-notes/source/bsp-scope.rst | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/release-notes/source/bsp-scope.rst b/release-notes/source/bsp-scope.rst
index 5035403..f036310 100644
--- a/release-notes/source/bsp-scope.rst
+++ b/release-notes/source/bsp-scope.rst
@@ -1,7 +1,34 @@
-BSP Scope
+Scope
 =========
 
-The scope of this release includes both meta-fsl-arm and meta-fsl-arm-extra.
+FSL Community BSP Scope
+---------
+The scope of this Release Notes includes the FSL Community BSP meta layers:
+
+ * `meta-fsl-arm <http://git.yoctoproject.org/cgit/cgit.cgi/meta-fsl-arm/?h=daisy>`_:
+   provides the base support and Freescale ARM reference boards;
+ * `meta-fsl-arm-extra <https://github.com/Freescale/meta-fsl-arm-extra/tree/daisy>`_:
+   provides support for 3rd party and partner boards;
+ * `meta-fsl-demos <https://github.com/Freescale/meta-fsl-demos/tree/daisy>`_:
+   provides images recipes, demo recipes, and packagegroups used to easy the development with Yocto Project.
+ * `Documentation <https://github.com/Freescale/Documentation>`_
+   provides the source code for FSL Community BSP Release Notes (RN), User Guide (UG) and
+   Frequentely Asked Question (FAQ)
+
+Kernel Release Notes
+--------------------
+
+The FSL Community BSP include support for several kernel providers, each machine
+may have a different Linux Kernel provider.
+
+For the provider **linux-imx**, Freescale has a Release Notes for each version released,
+this document has a list of known issues, new features, list of kernel arguments, and the
+linux-imx kernel scope for each Freescale Reference Board.
+
+See the respective Linux Kernel provider for your machine in section :ref:`linux-providers`
+
+Supported Board List
+--------------------
 Please, see in next table the complete supported board list.
 
 
-- 
1.8.3.2

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Daiane.Angolini]

> Subject: [Documentation][RFC 2/3] RN: Update BSP scope to point external
> links and Freescale RN
> 
> The Release Notes for the kernel is out of scope of this RN.
> 
> Please, help me to add the better pointer for release notes out of scope of
> FSL Community BSP but important for development, such as kernel release
> notes for linux providers others that linux-imx.

Please, Lou, Eric, Lauren, let me know if you disagree or if you have a better idea on how to handle this issue.


Daiane

> 
> Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
> ---
>  release-notes/source/bsp-scope.rst | 31 +++++++++++++++++++++++++++++--
>  1 file changed, 29 insertions(+), 2 deletions(-)
> 
> diff --git a/release-notes/source/bsp-scope.rst b/release-notes/source/bsp-
> scope.rst
> index 5035403..f036310 100644
> --- a/release-notes/source/bsp-scope.rst
> +++ b/release-notes/source/bsp-scope.rst
> @@ -1,7 +1,34 @@
> -BSP Scope
> +Scope
>  =========
> 
> -The scope of this release includes both meta-fsl-arm and meta-fsl-arm-
> extra.
> +FSL Community BSP Scope
> +---------
> +The scope of this Release Notes includes the FSL Community BSP meta
> layers:
> +
> + * `meta-fsl-arm <http://git.yoctoproject.org/cgit/cgit.cgi/meta-fsl-
> arm/?h=daisy>`_:
> +   provides the base support and Freescale ARM reference boards;
> + * `meta-fsl-arm-extra <https://github.com/Freescale/meta-fsl-arm-
> extra/tree/daisy>`_:
> +   provides support for 3rd party and partner boards;
> + * `meta-fsl-demos <https://github.com/Freescale/meta-fsl-
> demos/tree/daisy>`_:
> +   provides images recipes, demo recipes, and packagegroups used to easy
> the development with Yocto Project.
> + * `Documentation <https://github.com/Freescale/Documentation>`_
> +   provides the source code for FSL Community BSP Release Notes (RN), User
> Guide (UG) and
> +   Frequentely Asked Question (FAQ)
> +
> +Kernel Release Notes
> +--------------------
> +
> +The FSL Community BSP include support for several kernel providers,
> +each machine may have a different Linux Kernel provider.
> +
> +For the provider **linux-imx**, Freescale has a Release Notes for each
> +version released, this document has a list of known issues, new
> +features, list of kernel arguments, and the linux-imx kernel scope for
> each Freescale Reference Board.
> +
> +See the respective Linux Kernel provider for your machine in section
> +:ref:`linux-providers`
> +
> +Supported Board List
> +--------------------
>  Please, see in next table the complete supported board list.
> 
> 
> --
> 1.8.3.2

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Mario Domenech Goulart]

Hi Daiane,

On Wed, 11 Jun 2014 14:38:17 -0300 Daiane Angolini <daiane.angolini@freescale.com> wrote:

> The Release Notes for the kernel is out of scope of this RN.
>
> Please, help me to add the better pointer for release notes
> out of scope of FSL Community BSP but important for
> development, such as kernel release notes for linux providers
> others that linux-imx.
>
> Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
> ---
>  release-notes/source/bsp-scope.rst | 31 +++++++++++++++++++++++++++++--
>  1 file changed, 29 insertions(+), 2 deletions(-)
>
> diff --git a/release-notes/source/bsp-scope.rst b/release-notes/source/bsp-scope.rst
> index 5035403..f036310 100644
> --- a/release-notes/source/bsp-scope.rst
> +++ b/release-notes/source/bsp-scope.rst
> @@ -1,7 +1,34 @@
> -BSP Scope
> +Scope
>  =========
>  
> -The scope of this release includes both meta-fsl-arm and meta-fsl-arm-extra.
> +FSL Community BSP Scope
> +---------
> +The scope of this Release Notes includes the FSL Community BSP meta layers:

s/Release Notes/Release Notes document/

> +
> + * `meta-fsl-arm <http://git.yoctoproject.org/cgit/cgit.cgi/meta-fsl-arm/?h=daisy>`_:
> +   provides the base support and Freescale ARM reference boards;
> + * `meta-fsl-arm-extra <https://github.com/Freescale/meta-fsl-arm-extra/tree/daisy>`_:
> +   provides support for 3rd party and partner boards;
> + * `meta-fsl-demos <https://github.com/Freescale/meta-fsl-demos/tree/daisy>`_:
> +   provides images recipes, demo recipes, and packagegroups used to easy the development with Yocto Project.

s/easy/ease/

> + * `Documentation <https://github.com/Freescale/Documentation>`_
> +   provides the source code for FSL Community BSP Release Notes (RN), User Guide (UG) and
> +   Frequentely Asked Question (FAQ)

s/Frequentely/Frequently/
s/Question/Questions/

> +
> +Kernel Release Notes
> +--------------------
> +
> +The FSL Community BSP include support for several kernel providers

s/include/includes/

> , each machine
> +may have a different Linux Kernel provider.

I'd finish the previous sentence and start a new one: ". Each machine
may have a different Linux Kernel provider."

> +
> +For the provider **linux-imx**, Freescale has a Release Notes for each version released,

s/Release Notes/Release Notes document/

> +this document has a list of known issues, new features, list of kernel arguments, and the
> +linux-imx kernel scope for each Freescale Reference Board.
> +
> +See the respective Linux Kernel provider for your machine in section :ref:`linux-providers`
> +
> +Supported Board List
> +--------------------
>  Please, see in next table the complete supported board list.

Not part of the diff, but while I'm here, I suggest

  Please, see the next table for the complete list of supported boards.


Best wishes.
Mario
-- 
http://www.ossystems.com.br

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Daiane.Angolini]

> Subject: Re: [meta-freescale] [Documentation][RFC 2/3] RN: Update BSP scope
> to point external links and Freescale RN
> 
> Hi Daiane,

Thanks Mario.

I´m going add your suggestions. 

However i´m going to wait for some more revision before send v2.

Daiane

> 
> On Wed, 11 Jun 2014 14:38:17 -0300 Daiane Angolini
> <daiane.angolini@freescale.com> wrote:
> 
> > The Release Notes for the kernel is out of scope of this RN.
> >
> > Please, help me to add the better pointer for release notes out of
> > scope of FSL Community BSP but important for development, such as
> > kernel release notes for linux providers others that linux-imx.
> >
> > Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
> > ---
> >  release-notes/source/bsp-scope.rst | 31
> > +++++++++++++++++++++++++++++--
> >  1 file changed, 29 insertions(+), 2 deletions(-)
> >
> > diff --git a/release-notes/source/bsp-scope.rst
> > b/release-notes/source/bsp-scope.rst
> > index 5035403..f036310 100644
> > --- a/release-notes/source/bsp-scope.rst
> > +++ b/release-notes/source/bsp-scope.rst
> > @@ -1,7 +1,34 @@
> > -BSP Scope
> > +Scope
> >  =========
> >
> > -The scope of this release includes both meta-fsl-arm and meta-fsl-arm-
> extra.
> > +FSL Community BSP Scope
> > +---------
> > +The scope of this Release Notes includes the FSL Community BSP meta
> layers:
> 
> s/Release Notes/Release Notes document/
> 
> > +
> > + * `meta-fsl-arm <http://git.yoctoproject.org/cgit/cgit.cgi/meta-fsl-
> arm/?h=daisy>`_:
> > +   provides the base support and Freescale ARM reference boards;
> > + * `meta-fsl-arm-extra <https://github.com/Freescale/meta-fsl-arm-
> extra/tree/daisy>`_:
> > +   provides support for 3rd party and partner boards;
> > + * `meta-fsl-demos <https://github.com/Freescale/meta-fsl-
> demos/tree/daisy>`_:
> > +   provides images recipes, demo recipes, and packagegroups used to easy
> the development with Yocto Project.
> 
> s/easy/ease/
> 
> > + * `Documentation <https://github.com/Freescale/Documentation>`_
> > +   provides the source code for FSL Community BSP Release Notes (RN),
> User Guide (UG) and
> > +   Frequentely Asked Question (FAQ)
> 
> s/Frequentely/Frequently/
> s/Question/Questions/
> 
> > +
> > +Kernel Release Notes
> > +--------------------
> > +
> > +The FSL Community BSP include support for several kernel providers
> 
> s/include/includes/
> 
> > , each machine
> > +may have a different Linux Kernel provider.
> 
> I'd finish the previous sentence and start a new one: ". Each machine may
> have a different Linux Kernel provider."
> 
> > +
> > +For the provider **linux-imx**, Freescale has a Release Notes for
> > +each version released,
> 
> s/Release Notes/Release Notes document/
> 
> > +this document has a list of known issues, new features, list of
> > +kernel arguments, and the linux-imx kernel scope for each Freescale
> Reference Board.
> > +
> > +See the respective Linux Kernel provider for your machine in section
> > +:ref:`linux-providers`
> > +
> > +Supported Board List
> > +--------------------
> >  Please, see in next table the complete supported board list.
> 
> Not part of the diff, but while I'm here, I suggest
> 
>   Please, see the next table for the complete list of supported boards.
> 
> 
> Best wishes.
> Mario
> --
> http://www.ossystems.com.br

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[zhenhua.luo]

Hi Daiane, 

Can the meta-fsl-ppc layer info be added in this patch, or should a separate patch be submitted to add the ppc layer info?


Best Regards,

Zhenhua

> -----Original Message-----
> From: meta-freescale-bounces@yoctoproject.org [mailto:meta-freescale-
> bounces@yoctoproject.org] On Behalf Of Daiane.Angolini@freescale.com
> Sent: Thursday, June 12, 2014 2:18 AM
> To: Mario Domenech Goulart
> Cc: meta-freescale@yoctoproject.org
> Subject: Re: [meta-freescale] [Documentation][RFC 2/3] RN: Update BSP
> scope to point external links and Freescale RN
> 
> > Subject: Re: [meta-freescale] [Documentation][RFC 2/3] RN: Update BSP
> > scope to point external links and Freescale RN
> >
> > Hi Daiane,
> 
> Thanks Mario.
> 
> I´m going add your suggestions.
> 
> However i´m going to wait for some more revision before send v2.
> 
> Daiane
> 
> >
> > On Wed, 11 Jun 2014 14:38:17 -0300 Daiane Angolini
> > <daiane.angolini@freescale.com> wrote:
> >
> > > The Release Notes for the kernel is out of scope of this RN.
> > >
> > > Please, help me to add the better pointer for release notes out of
> > > scope of FSL Community BSP but important for development, such as
> > > kernel release notes for linux providers others that linux-imx.
> > >
> > > Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
> > > ---
> > >  release-notes/source/bsp-scope.rst | 31
> > > +++++++++++++++++++++++++++++--
> > >  1 file changed, 29 insertions(+), 2 deletions(-)
> > >
> > > diff --git a/release-notes/source/bsp-scope.rst
> > > b/release-notes/source/bsp-scope.rst
> > > index 5035403..f036310 100644
> > > --- a/release-notes/source/bsp-scope.rst
> > > +++ b/release-notes/source/bsp-scope.rst
> > > @@ -1,7 +1,34 @@
> > > -BSP Scope
> > > +Scope
> > >  =========
> > >
> > > -The scope of this release includes both meta-fsl-arm and
> > > meta-fsl-arm-
> > extra.
> > > +FSL Community BSP Scope
> > > +---------
> > > +The scope of this Release Notes includes the FSL Community BSP meta
> > layers:
> >
> > s/Release Notes/Release Notes document/
> >
> > > +
> > > + * `meta-fsl-arm
> > > + <http://git.yoctoproject.org/cgit/cgit.cgi/meta-fsl-
> > arm/?h=daisy>`_:
> > > +   provides the base support and Freescale ARM reference boards;
> > > + * `meta-fsl-arm-extra <https://github.com/Freescale/meta-fsl-arm-
> > extra/tree/daisy>`_:
> > > +   provides support for 3rd party and partner boards;
> > > + * `meta-fsl-demos <https://github.com/Freescale/meta-fsl-
> > demos/tree/daisy>`_:
> > > +   provides images recipes, demo recipes, and packagegroups used to
> > > + easy
> > the development with Yocto Project.
> >
> > s/easy/ease/
> >
> > > + * `Documentation <https://github.com/Freescale/Documentation>`_
> > > +   provides the source code for FSL Community BSP Release Notes
> > > + (RN),
> > User Guide (UG) and
> > > +   Frequentely Asked Question (FAQ)
> >
> > s/Frequentely/Frequently/
> > s/Question/Questions/
> >
> > > +
> > > +Kernel Release Notes
> > > +--------------------
> > > +
> > > +The FSL Community BSP include support for several kernel providers
> >
> > s/include/includes/
> >
> > > , each machine
> > > +may have a different Linux Kernel provider.
> >
> > I'd finish the previous sentence and start a new one: ". Each machine
> > may have a different Linux Kernel provider."
> >
> > > +
> > > +For the provider **linux-imx**, Freescale has a Release Notes for
> > > +each version released,
> >
> > s/Release Notes/Release Notes document/
> >
> > > +this document has a list of known issues, new features, list of
> > > +kernel arguments, and the linux-imx kernel scope for each Freescale
> > Reference Board.
> > > +
> > > +See the respective Linux Kernel provider for your machine in
> > > +section :ref:`linux-providers`
> > > +
> > > +Supported Board List
> > > +--------------------
> > >  Please, see in next table the complete supported board list.
> >
> > Not part of the diff, but while I'm here, I suggest
> >
> >   Please, see the next table for the complete list of supported boards.
> >
> >
> > Best wishes.
> > Mario
> > --
> > http://www.ossystems.com.br
> --
> _______________________________________________
> meta-freescale mailing list
> meta-freescale@yoctoproject.org
> https://lists.yoctoproject.org/listinfo/meta-freescale

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Otavio Salvador]

On Thu, Jun 12, 2014 at 3:58 AM, zhenhua.luo@freescale.com
<zhenhua.luo@freescale.com> wrote:
> Can the meta-fsl-ppc layer info be added in this patch, or should a separate patch be submitted to add the ppc layer info?

I think it should be a separated patch. It'd be awesome if you could
cook this patch and send so Daiane can put it in a branch and we add
the meta-fsl-ppc there while we work in the integration for master.

Daiane?

-- 
Otavio Salvador                             O.S. Systems
http://www.ossystems.com.br        http://code.ossystems.com.br
Mobile: +55 (53) 9981-7854            Mobile: +1 (347) 903-9750

Re: [Documentation][RFC 2/3] RN: Update BSP scope to point external links and Freescale RN

[Daiane.Angolini]

> Hi Daiane,
> 
> Can the meta-fsl-ppc layer info be added in this patch, or should a
> separate patch be submitted to add the ppc layer info?

That´s what I´m asking help for

;-)

Let´s talk offline

Daiane

[Documentation][RFC 3/3] RN: Add the Release Schedule section

[Daiane Angolini]

Say it is based on Yocto Project.

Please comment on how to point to YP URL.

Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
---
 release-notes/source/introduction.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/release-notes/source/introduction.rst b/release-notes/source/introduction.rst
index a81fc7d..68015aa 100644
--- a/release-notes/source/introduction.rst
+++ b/release-notes/source/introduction.rst
@@ -4,3 +4,13 @@ Introduction
 This document has the release notes of the FSL Community BSP |release|
 which is a communty effort to improve Freescale's
 processors support in OpenEmbedded and in the Yocto Project.
+
+Release Schedule
+----------------
+
+The FSL Communtiy BSP follows the same release schedule from Yocto Project.
+Since Yocto Project release 1.3 (denzil) meta-fsl-arm, meta-fsl-demos and meta-fsl-arm-extra
+follow the same *release schedule* and the same *branch naming* from Yocto Project.
+
+See the `Yocto Projec Release <https://wiki.yoctoproject.org/wiki/Releases>`_, for details
+on the Yocto Project.
-- 
1.8.3.2

Re: [Documentation][RFC 3/3] RN: Add the Release Schedule section

[Mario Domenech Goulart]

Hi Daiane,

On Wed, 11 Jun 2014 14:38:18 -0300 Daiane Angolini <daiane.angolini@freescale.com> wrote:

> Say it is based on Yocto Project.
>
> Please comment on how to point to YP URL.
>
> Signed-off-by: Daiane Angolini <daiane.angolini@freescale.com>
> ---
>  release-notes/source/introduction.rst | 10 ++++++++++
>  1 file changed, 10 insertions(+)
>
> diff --git a/release-notes/source/introduction.rst b/release-notes/source/introduction.rst
> index a81fc7d..68015aa 100644
> --- a/release-notes/source/introduction.rst
> +++ b/release-notes/source/introduction.rst
> @@ -4,3 +4,13 @@ Introduction
>  This document has the release notes of the FSL Community BSP |release|
>  which is a communty effort to improve Freescale's
>  processors support in OpenEmbedded and in the Yocto Project.
> +
> +Release Schedule
> +----------------
> +
> +The FSL Communtiy BSP follows the same release schedule from Yocto Project.

I suggest

  The FSL Community BSP follows the same release schedule as
  the Yocto Project's.

If you don't agree with the suggestion, please, note the
s/Communtiy/Community/ typo fix.

> +Since Yocto Project release 1.3 (denzil) meta-fsl-arm, meta-fsl-demos and meta-fsl-arm-extra
> +follow the same *release schedule* and the same *branch naming* from Yocto Project.

s/Yocto Project/the Yocto Project/

> +
> +See the `Yocto Projec Release <https://wiki.yoctoproject.org/wiki/Releases>`_, for details
> +on the Yocto Project.

I suggest 

  See the `Yocto Project Releases <https://wiki.yoctoproject.org/wiki/Releases>`_ document
  for details on the Yocto Project.

(note s/Projec Release/Project Releases/)

I don't know what the `_' character is for in that sentence. I assume it
is a rst syntax, so I've kept it.  If it is noise, please consider
removing it.

Mario
-- 
http://www.ossystems.com.br

Re: [Documentation][RFC 3/3] RN: Add the Release Schedule section

[Daiane Angolini]

> I don't know what the `_' character is for in that sentence. I assume it
> is a rst syntax, so I've kept it.  If it is noise, please consider
> removing it.

Hi Mario, thanks a lot for your suggestions.

I have fixed/updated the patches.

Lou, I have uploaded the patches on my personal github, this way we
can rework then before merging into the original project.

https://github.com/angolini/Documentation

Regards,
Daiane