[yocto] Yocto Project Janitors Wiki

[Osier-mixon, Jeffrey]

I think my descriptions are more confusing than my intent. Evidently I have not had enough coffee yet today. I'll try to summarize more betterly:

- the text that starts "When adding tasks..." and ending with "..not a good fit for this task list" would work better in the introductory section above the header "Tasks"

- I was looking for a TOC right under the header "Tasks" and missed the one that already exists at the top of the page, user error on my part

Also:

- You can remove the "NOTE" - the page is a good addition to the site that needs no caveat

Thanks again for setting this up. I have had a page like this on my to-do list for a while.


-----Original Message-----
From: Darren Hart [mailto:dvhart at linux.intel.com] 
Sent: Friday, April 15, 2011 1:44 PM
To: Osier-mixon, Jeffrey
Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors Wiki

On 04/15/2011 01:24 PM, Osier-mixon, Jeffrey wrote:
> Maybe I'm the one who is confused. Looking at the contents of the
> Janitors page - I expected to see a list of existing things that need
> to be cleaned up. 

Cleaned-up, improved, etc. The page currently contains 3 tasks/projects:

1) Document undocumented variables according to bbvars.py
2) Rewrite bbvars.py to use bitbake to find variables
3) Modify create-pull-request and send-pull-request to use
git-request-pull directly.

> The most visible thing on the page is the
> description of how to enter tasks, and I think I assumed that was all
> that was there.

I'm referring to how to add new tasks to this Janitors wiki itself... is
that not what you were thinking I meant?

> It might be best to put the tasks format above the
> list of actual tasks so it doesn't look like the main focus of the
> list.

The tasks format IS above the list of actual tasks... did you mean "be
best NOT to put..."?

> Might also be good to add an auto-generated TOC right under the
> Tasks header - I'll look up how to make the wiki do that.

As opposed to the TOC at the top of the page?

> 
> Re submission guidelines - I'm working on a set of pages that show
> new participants how to submit code or documentation to the project.
> Part of these guidelines is details just like the "how to enter new
> tasks" description, so I may borrow that.

Perhaps the tasks themselves should be a Heading level (3 in this case).
That would make them stand out more and make them appear in the TOC.

--
Darren

> 
> -----Original Message----- From: Darren Hart
> [mailto:dvhart at linux.intel.com] Sent: Friday, April 15, 2011 1:16 PM 
> To: Osier-mixon, Jeffrey Cc: Yocto Project; Rifenbark, Scott M 
> Subject: Re: Yocto Project Janitors Wiki
> 
> On 04/15/2011 11:26 AM, Osier-mixon, Jeffrey wrote:
>> WOW fantastic, thanks for doing this.
>> 
>> It occurs to me that the items you put there are really specific 
>> submission guidelines,
> 
> I'm not following you here. "Submission Guidelines" ?
> 
> although that could be considered a janitorial
>> task in cleaning things up. I have it on my to-do list (soon
>> rather than someday) to create detailed participation guidelines,
>> and these should be a part of them. When I do that, maybe I'll move
>> these over and then create a link back, with "clean up existing
>> submissions" as part of the Janitor list. Does that make sense, or
>> am I misunderstanding your intent?
> 
> .. ditto ..
> 
> -- Darren
> 
>> 
>> -----Original Message----- From: Darren Hart 
>> [mailto:dvhart at linux.intel.com] Sent: Friday, April 15, 2011 11:20 
>> AM To: Yocto Project Cc: Rifenbark, Scott M; Osier-mixon, Jeffrey 
>> Subject: RFC: Yocto Project Janitors Wiki
>> 
>> I had a few too many tasks getting added to my Someday list and I 
>> thought this was a good opportunity to create the Janitors Task 
>> list. This is what I came up with:
>> 
>> https://wiki.yoctoproject.org/wiki/Janitors
>> 
>> Please have a look and provide your thoughts on the general
>> concept, the task format, etc.
>> 
>> I've CC'd Scott as the Documentation tasks are really his, I was 
>> just involved with writing the bbvars. We definitely need people
>> to do the research on those variables, but if they send patches, or
>> just text descriptions is really up to Scott - so that task may
>> need editing.
>> 
>> Finally, if you like the idea and have some of your own Someday 
>> tasks, please feel free to add them.
>> 
> 

-- 
Darren Hart
Intel Open Source Technology Center
Yocto Project - Linux Kernel