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:dvh...@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:dvh...@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:dvh...@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 _______________________________________________ yocto mailing list yocto@yoctoproject.org https://lists.yoctoproject.org/listinfo/yocto