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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
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:[email protected]]
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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
Quoted 4 lines · Jeffrey
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
Quoted 6 lines
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
Quoted 24 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 11:20 AM To: Yocto Project Cc: Rifenbark, Scott M; Osier-mixon, Jeffrey
Subject: RFC: Yocto Project Janitors WikiI 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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
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:[email protected]]
Sent: Friday, April 15, 2011 1:16 PM
To: Osier-mixon, Jeffrey
Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors Wiki
Quoted 4 lines · Jeffrey
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
Quoted 6 lines
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
Quoted 24 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 11:20 AM To: Yocto Project Cc: Rifenbark, Scott M; Osier-mixon, Jeffrey
Subject: RFC: Yocto Project Janitors WikiI 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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
Quoted 3 lines · 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.
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.
Quoted 3 lines
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?
Quoted 3 lines
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..."?
Quoted 2 lines
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?
Quoted 5 lines
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
Quoted 51 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 1:16 PM
To: Osier-mixon, Jeffrey Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors WikiQuoted 4 lines · Jeffrey
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
Quoted 6 lines
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
Quoted 24 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 11:20 AM To: Yocto Project Cc: Rifenbark, Scott M; Osier-mixon, Jeffrey
Subject: RFC: Yocto Project Janitors WikiI 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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
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:[email protected]]
Sent: Friday, April 15, 2011 1:44 PM
To: Osier-mixon, Jeffrey
Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors Wiki
Quoted 3 lines · 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.
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.
Quoted 3 lines
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?
Quoted 3 lines
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..."?
Quoted 2 lines
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?
Quoted 5 lines
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
Quoted 51 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 1:16 PM
To: Osier-mixon, Jeffrey Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors WikiQuoted 4 lines · Jeffrey
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
Quoted 6 lines
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
Quoted 24 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 11:20 AM To: Yocto Project Cc: Rifenbark, Scott M; Osier-mixon, Jeffrey
Subject: RFC: Yocto Project Janitors WikiI 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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel
Re: Yocto Project Janitors Wiki
Quoted 3 lines · 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:
;-)
Quoted 3 lines
- 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
Quoted 5 lines
- 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
Quoted 5 lines
Also:
- You can remove the "NOTE" - the page is a good addition to the site that needs no caveat
Done
Quoted 2 lines
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
Quoted 101 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 1:44 PM
To: Osier-mixon, Jeffrey Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors WikiQuoted 3 lines · 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.
Cleaned-up, improved, etc. The page currently contains 3 tasks/projects:
1) Document undocumented variables according to
bbvars.py2) Rewritebbvars.pyto use bitbake to find variables 3) Modify create-pull-request and send-pull-request to use git-request-pull directly.Quoted 2 lines
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?
Quoted 2 lines
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..."?
Quoted 2 lines
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?
Quoted 5 lines
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
Quoted 51 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] Sent: Friday, April 15, 2011 1:16 PM To: Osier-mixon, Jeffrey Cc: Yocto Project; Rifenbark, Scott M
Subject: Re: Yocto Project Janitors WikiQuoted 4 lines · Jeffrey
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
Quoted 6 lines
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
Quoted 24 lines
-----Original Message----- From: Darren Hart [mailto:[email protected]] 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.
Signature · 3 lines
Darren Hart Intel Open Source Technology Center Yocto Project - Linux Kernel