[yocto] Yocto Project Janitors Wiki

[Darren Hart]

On 04/15/2011 01:51 PM, Osier-mixon, Jeffrey wrote:
> 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"

Done

> 
> - 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
>

OK


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

Done

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

Great. So now, whenever someone says "someday I'm going to..." we need
to point them to the wiki.

We really need yoctobot on #yocto :-)

Oh! Hah... guess I should add that to the page ;-)

--
Darren

> 
> 
> -----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