On Mon, Aug 20, 2012 at 08:55:34PM +0000, Rifenbark, Scott M wrote:
> Regarding the text on the https://lists.yoctoproject.org link.  Who 
> maintains that page?

It's generated from each list's configuration data. Corresponding list 
maintainers or mailman admin (Michael?) can change the descriptions, like I 
just did for meta-ti.

-- 
Denys


> -----Original Message-----
> From: Denys Dmytriyenko [mailto:de...@ti.com] 
> 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
yocto@yoctoproject.org
https://lists.yoctoproject.org/listinfo/yocto

Reply via email to