RFC: Yocto Project Janitors Wiki

RFC: Yocto Project Janitors Wiki

[Darren Hart]

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

Re: Yocto Project Janitors Wiki

[Osier-mixon, Jeffrey]

WOW fantastic, thanks for doing this. 

It occurs to me that the items you put there are really specific 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?

-----Original Message-----
From: Darren Hart [mailto:dvhart@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

Re: Yocto Project Janitors Wiki

[Darren Hart]

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

Re: Yocto Project Janitors Wiki

[Osier-mixon, Jeffrey]

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

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.

-----Original Message-----
From: Darren Hart [mailto:dvhart@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@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

Re: Yocto Project Janitors Wiki

[Darren Hart]

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

Re: 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@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@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@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

Re: 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@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@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@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