I can replace the information on 
http://www.yoctoproject.org/community/mailing-lists with a generic bit about 
mailing lists and then provide a link to the https://lists.yoctoproject.org/ 
page.  Regarding the text on the https://lists.yoctoproject.org link.  Who 
maintains that page?

Scott

-----Original Message-----
From: Denys Dmytriyenko [mailto:[email protected]] 
Sent: Monday, August 20, 2012 12:15 PM
To: Darren Hart
Cc: Yocto Project; Rifenbark, Scott M; Paul Gortmaker; Richard Purdie; Wold, 
Saul; Paul Eggleton; Osier-mixon, Jeffrey; Zanussi, Tom; Hudson, Sean; Koen 
Kooi; Jason Kridner; Flanagan, Elizabeth; Michael Halstead
Subject: Re: Documenting the mailing lists.

On Mon, Aug 20, 2012 at 11:43:38AM -0700, Darren Hart wrote:
> Scott,
> 
> We've come across some more confusion about mailing lists recently. I've
> sent a patch against poky to try and clear it up a bit in the source,
> but we should also see about cleaning up the web descriptions of the lists.
> 
> We have two pages that describe the lists:
> 
> http://www.yoctoproject.org/community/mailing-lists
> https://lists.yoctoproject.org/
> 
> My first recommendation would be to eliminate
> http://www.yoctoproject.org/community/mailing-lists and replace links to
> it with links to https://lists.yoctoproject.org. This eliminates the
> need to keep the CMS version in sync with the mailman page. The mailman
> page should be considered the master anyway as the Description field is
> taken directly from the list administrative settings.

I completely agree with this proposal to unify and clean up the mailing list 
references and descriptions. I didn't even know there was a separate page at 
http://www.yoctoproject.org/community/mailing-lists - probably because I was 
happy with https://lists.yoctoproject.org/ all the time :)


> We should then work to create meaningful Descriptions of all the lists.
> These should still fit on a single line, but I think we can improve on
> what we have. For example:
> 
> meta-ti               Mailing list for the meta-ti layer
> 
> is not particularly enlightening. Perhaps something like:
> 
> meta-ti               Usage and development of the meta-ti layer

Not sure if this improves much - in either case it's just a generic 
description of the mailing list that is specific to the corresponding layer, 
meta-ti. But I'm fine with the change, as long as we are unifying all the 
other list descriptions.


> If we do this all at once, we can also ensure a consistent language,
> tone, etc.

Exactly! Thanks for initiating this.


> I'll propose something for each list here and ask that
> interested parties comment and correct in reply. Once agreed upon, the
> admins of the respective lists can make the changes (all CC'd)
> 
> Current:
> ========
> linux-yocto   Development list for the linux-yocto*.git Linux kernel
>               repositories
> meta-ti       Mailing list for the meta-ti layer
> poky          Poky build system developer discussion & patch
>               submission for meta-yocto
> shoeleather   Neutral Board Lab Mailing List
> yocto                 Discussion of all things Yocto
> yocto-ab      Yocto Project Advisory Board
> yocto-advocacy        Yocto Project Advocacy & Outreach AB Subgroup
> yocto-announce        Announcements from the Yocto Project
> yocto-bsp     BSP Interest Group
> Yocto-builds  Build failures and discusion about the build system
> yocto-infrastructure  Infrastructure
> 
> 
> Proposed:
> =========
> linux-yocto   Development list for the linux-yocto*.git Linux kernel
>               repositories
> meta-ti       Usage and development list for the meta-ti layer
> poky          Usage and development list for the Poky build system
>               (see README for patch submission)
> shoeleather   Neutral Board Lab Mailing List
> 
> I'm not sure what "neutral" is meant to convey. How about:
> 
>               Discussion list for the Shoeleather embedded board lab
> 
> yocto                 General discussion list for the Yocto Project and
>               development for projects without dedicated lists
> 
> I think the yocto list is a bit problematic in that it mixes project
> conceptual discussion, user help desk, and development all on the same
> list. However, I'm trying to clarify what these actually are here - not
> change anything.
> 
> yocto-ab      Yocto Project Advisory Board ???
> 
> This should imply the intended audience. Is it just meant for members?
> Is it meant as a way for non-AB members to observe what is going on?
> 
> yocto-advocacy        Yocto Project advocacy & outreach AB subgroup
> 
> Same as above.
> 
> yocto-announce        Announcements from the Yocto Project (low traffic)
> yocto-bsp     BSP Interest Group ???
> 
> There is no detailed description for this list, so I'm not sure what
> this is really about.
> 
> Yocto-builds  Build failures and discussion about the autobuilder
> 
> (includes typo fix, "build system" removed to avoid confusion with the
> "poky build system")
> 
> yocto-infrastructure  Infrastructure ???
> 
> Jefro or Michael, can you come up with something appropriate here?
> 
> 
> For lists where certain guidelines should be used in communications and
> patch submission, we should document that in the detailed description of
> the list, such as [project] tags for example.

-- 
Denys
_______________________________________________
yocto mailing list
[email protected]
https://lists.yoctoproject.org/listinfo/yocto

Reply via email to