From drupal at rocktreesky.com Thu Jul 2 18:46:08 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 2 Jul 2009 14:46:08 -0400 Subject: [documentation] Doc IA interviews needed References: <20090702183036.7E1A816B4E5@www1.drupal.org> Message-ID: <4B336AE8-020E-4FF2-9607-D62B36B2BD66@rocktreesky.com> > add1sun has posted a Discussion at http://groups.drupal.org/node/23848 > > Doc IA interviews needed > --------------- > One of the many pieces of feedback that Becca needs to help with > redesigning our doc information architecture will be gathered > through stakeholder interviews. Who are stakeholders? US! We need > people who use (and maintain) the Drupal docs to help us with > interviews, both as interviewers and interviewees. There is a sign > up form to get involved. (http://spreadsheets.google.com/viewform?formkey=cjk3c0IxNVNCWVBzMnFUV21xSWw0LXc6MA > ) > Becca will provide more info on how it works, but basically we'll > have a little script of questions to ask which you can use to chat > in person or over Skype, etc. Record the interview (either in notes, > audio or both) and then upload your results. It is a great way to > get to know other community members while really helping to make our > docs better. I have a bit more about this and some related things in > a recent post on my blog, which went to the Planet a few days ago (http://rocktreesky.com/need-some-help-surveys-interviews-and-recording > ). - Addi From futuredeveloper at hotmail.com Thu Jul 2 23:49:08 2009 From: futuredeveloper at hotmail.com (Mark Valentine) Date: Thu, 2 Jul 2009 17:49:08 -0600 Subject: [documentation] Error with hook_help() ??? Message-ID: Hi, all. I was wondering if someone could independently verify a bug for me. On the documentation for drupal 5, under hook_help ( http://api.drupal.org/api/function/hook_help/5 ), it lists some 'descriptors' that modify where help will be displayed. The 4th one down node/add#nodetype doesn't seem to work as advertised. 'node/add#nodetype The description of a node type (if applicable).' I assume that means that when someone goes to the drupal path the text will be displayed at the top top of the screen. Am I reading this correctly? However, from my testing this does not happen, in fact nothing happens. It does display the text at the top if $section==node/add/myNodeType. Could someone help me verify this before I start yelling bug or trying to change the documententation on drupal.org :) Thanks, Mark _________________________________________________________________ Insert movie times and more without leaving Hotmail?. http://windowslive.com/Tutorial/Hotmail/QuickAdd?ocid=TXT_TAGLM_WL_HM_Tutorial_QuickAdd_062009 -------------- next part -------------- An HTML attachment was scrubbed... URL: From drupal at rocktreesky.com Sun Jul 5 22:14:39 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 5 Jul 2009 18:14:39 -0400 Subject: [documentation] Doc IRC meeting July 10 re: Drupal 7 References: <20090705193012.B93DF16B5A8@www1.drupal.org> Message-ID: > add1sun has posted a Event at http://groups.drupal.org/node/23903 > > Doc IRC meeting July 10 re: Drupal 7 > --------------- > We will meet on IRC (#drupal-docs on Freenode) Friday, July 10 at 2 > p.m. EDT (18:00 GMT, 11 a.m. PDT). This meeting is to start getting > ourselves organized for Drupal 7 documentation. We need to determine > what our minimum needs are for docs that will be ready on the day > Drupal 7 launches (whenever that is) and at least a rough schedule > to make sure we deliver on time. Code freeze is on September 1, 2009 > and release will most likely be at least a few months after that. - Addi -------------- next part -------------- An HTML attachment was scrubbed... URL: From drupal at rocktreesky.com Mon Jul 20 01:46:58 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 19 Jul 2009 18:46:58 -0700 Subject: [documentation] July 10 D7 docs IRC meeting summary and log References: <20090720003016.A7CC216B553@www1.drupal.org> Message-ID: <85D1BC4D-5221-4C5A-96B6-66E766F7A73D@rocktreesky.com> > add1sun has posted a Discussion at http://groups.drupal.org/node/24402 > > July 10 D7 docs IRC meeting summary and log > --------------- > Sorry for the delay in getting this up. Here is the IRC log for the > IRC meeting from July 10 where we discussed docs for Drupal 7: http://pastebin.com/f244a7fc2 > Here is a short summary of the major points: > We need to identify what we consider "critical" for D7 docs. That > is, what is the minimum that is required when Drupal 7 official > release goes live. We also need to set up some sort of timeline and > then organize to get the work the done timely. There is a draft > outline getting built out at http://drupal.org/node/515870, in the > Docs Community Initiatives section. We need to keep fleshing this > out. We will have bi-weekly IRC meetings on D7 docs to keep this on > radar and make sure we keep moving forward incrementally. > There are concerns about starting now and timing things out since so > much of the D7 interface is likely to change between now and code > freeze. There are certain areas, like upgrading, that should be > fairly stable to write against for now and the rest of our crucial > stuff should have a solid outline and skeleton writing done before > code freeze, Sept. 1, so that we can dive into the work during the > two sprints that will happen around Drupalcon Paris (both onsite and > online). There are also concerns about how this will fit in with the > new IA that is currently being worked on. Unfortunately we don't > have the time to wait for the new IA before we mobilize on D7 docs, > so we need to move ahead and, yeah, we may need to rip out and redo > sections once the new IA is in place. So be it. - Addi From drupal at rocktreesky.com Mon Jul 20 01:47:51 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 19 Jul 2009 18:47:51 -0700 Subject: [documentation] Schedule next D7 doc IRC meeting References: <20090720003016.B56B916B553@www1.drupal.org> Message-ID: > add1sun has posted a Discussion at http://groups.drupal.org/node/24404 > > Schedule next D7 doc IRC meeting > --------------- > At the Drupal 7 docs IRC meeting on July 10, we decided to have bi- > weekly meetings to keep D7 docs on track. We will meet in #drupal- > docs on Freenode for one hour. The Doodle to voice your date/time > preferences is at http://www.doodle.com/zd4rn6mkdmc7friw - Addi From drupal at rocktreesky.com Sun Jul 26 17:24:47 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 26 Jul 2009 13:24:47 -0400 Subject: [documentation] D7 docs IRC meeting - Friday July 31 References: <20090726165014.E24A316B558@www1.drupal.org> Message-ID: <4108CDE4-7668-4312-AFAA-18DEEA58B33F@rocktreesky.com> > add1sun has posted a Event at http://groups.drupal.org/node/24667 > > D7 docs IRC meeting > --------------- > Let's keep the Drupal 7 docs on our radar. Next IRC meeting > (freenode #drupal-docs) will be for one hour on Friday, July 31 at 2 > pm EDT (18:00 GMT, 8pm CET, 11am PDT, find your time: http://www.timeanddate.com/worldclock/fixedtime.html?month=7&day=31&year=2009&hour=14&min=0&sec=0&p1=419) > . We'll go over and continue to flesh out the overview list (http://drupal.org/node/515870 > ), as well as assign tasks to be done in the next two weeks. You can > catch up on the discussion by reading the first D7 meeting's minutes > (http://groups.drupal.org/node/24402). - Addi From drupal at rocktreesky.com Sun Jul 26 17:47:48 2009 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 26 Jul 2009 13:47:48 -0400 Subject: [documentation] September Sprint organization Message-ID: Hey there folks, Drupalcon Paris and code freeze is a little over 5 weeks away now. Part of Drupalcon this year is not just one, but two sprint days, Sept 1st and 5th. Last 'con we had a lot of people show up for the doc sprint and we self-organized fairly well. This year I'd like to have things more planned out ahead of time since we have a lot of different things going on in our docs world these days. I know that everyone can't make it to Paris and so I am particularly keen to figure out a good way to coordinate a virtual sprint with the live sprint in Paris. I want to start talking about it now and see what we come up with. I think having some "sub-groups" around particular things would be good. sort of like how we had the coder and style guide tables in DC. Some stuff that comes immediately to mind as possibilities are: - D7 docs - Newbies - Code projects - Roadmap groups (i.e. maybe IA, reward system, peer/metoring groups) We could start posting up a rough game plan of things that we want to accomplish by the end of the con week for various areas. I also think the "cat-herder" plan at DC worked pretty well (where folks volunteered to cat-herd, got a button to identify them, and helped others get oriented, etc.), so thoughts on that are appreciated. Did it work for you guys? Can we improve it? Any ideas on how to keep communication/workflow better between virtual and live sprinters are really neeeded, since I don't feel like I've had much success on that front. - Addi From drupal at ryancross.com Sun Jul 26 23:16:53 2009 From: drupal at ryancross.com (Ryan Cross) Date: Mon, 27 Jul 2009 09:16:53 +1000 Subject: [documentation] September Sprint organization In-Reply-To: References: Message-ID: <4e983be00907261616n6977ce15sb66f284cd48080fb@mail.gmail.com> Hey Addi, I'll be at DrupalCon and probably split my time between coding and doc sprints. One suggestion for coordinating the virtual and live sprints, I think it might make sense to have some at the live event monitoring the back channel (irc, twitter, etc) and then pulling in the various relevant groups for people to connect. Sounds like a "cat herder" for the virtual participants :) this person could also help to answer all the "what are we working on" "where should we go" type things that might distract the live participants and dissuade from monitoring the irc channel -Ryan On Mon, Jul 27, 2009 at 3:47 AM, Addison Berry wrote: > Hey there folks, > > Drupalcon Paris and code freeze is a little over 5 weeks away now. Part of > Drupalcon this year is not just one, but two sprint days, Sept 1st and 5th. > Last 'con we had a lot of people show up for the doc sprint and we > self-organized fairly well. This year I'd like to have things more planned > out ahead of time since we have a lot of different things going on in our > docs world these days. I know that everyone can't make it to Paris and so I > am particularly keen to figure out a good way to coordinate a virtual sprint > with the live sprint in Paris. > > I want to start talking about it now and see what we come up with. I think > having some "sub-groups" around particular things would be good. sort of > like how we had the coder and style guide tables in DC. Some stuff that > comes immediately to mind as possibilities are: > - D7 docs > - Newbies > - Code projects > - Roadmap groups (i.e. maybe IA, reward system, peer/metoring groups) > > We could start posting up a rough game plan of things that we want to > accomplish by the end of the con week for various areas. I also think the > "cat-herder" plan at DC worked pretty well (where folks volunteered to > cat-herd, got a button to identify them, and helped others get oriented, > etc.), so thoughts on that are appreciated. Did it work for you guys? Can we > improve it? Any ideas on how to keep communication/workflow better between > virtual and live sprinters are really neeeded, since I don't feel like I've > had much success on that front. > > - Addi > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: From margaux at grandjunctiondesign.com Sun Jul 26 23:51:51 2009 From: margaux at grandjunctiondesign.com (Margaux O'Malley) Date: Sun, 26 Jul 2009 19:51:51 -0400 Subject: [documentation] September Sprint organization Message-ID: <573AD6F2B9C5B24AAB6CEEA472A0CA4184D910@be40.exg3.exghost.com> I thought the cat herder concept worked well at the DC 'con. I will not be in Paris but am planning to join you by IRC. If you have remote IRC cat herders I'm happy to be one, though it seems to make more sense that the cat herders would all be there in Paris, even those leading the IRCers. -Margaux ----- Original Message ----- From: documentation-bounces at drupal.org To: documentation at drupal.org Sent: Sun Jul 26 13:47:48 2009 Subject: [documentation] September Sprint organization Hey there folks, Drupalcon Paris and code freeze is a little over 5 weeks away now. Part of Drupalcon this year is not just one, but two sprint days, Sept 1st and 5th. Last 'con we had a lot of people show up for the doc sprint and we self-organized fairly well. This year I'd like to have things more planned out ahead of time since we have a lot of different things going on in our docs world these days. I know that everyone can't make it to Paris and so I am particularly keen to figure out a good way to coordinate a virtual sprint with the live sprint in Paris. I want to start talking about it now and see what we come up with. I think having some "sub-groups" around particular things would be good. sort of like how we had the coder and style guide tables in DC. Some stuff that comes immediately to mind as possibilities are: - D7 docs - Newbies - Code projects - Roadmap groups (i.e. maybe IA, reward system, peer/metoring groups) We could start posting up a rough game plan of things that we want to accomplish by the end of the con week for various areas. I also think the "cat-herder" plan at DC worked pretty well (where folks volunteered to cat-herd, got a button to identify them, and helped others get oriented, etc.), so thoughts on that are appreciated. Did it work for you guys? Can we improve it? Any ideas on how to keep communication/workflow better between virtual and live sprinters are really neeeded, since I don't feel like I've had much success on that front. - Addi -- Pending work: http://drupal.org/project/issues/documentation/ List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: From yahgrp at poplarware.com Mon Jul 27 15:08:55 2009 From: yahgrp at poplarware.com (Jennifer Hodgdon) Date: Mon, 27 Jul 2009 08:08:55 -0700 Subject: [documentation] D7 docs IRC meeting - Friday July 31 In-Reply-To: <4108CDE4-7668-4312-AFAA-18DEEA58B33F@rocktreesky.com> References: <20090726165014.E24A316B558@www1.drupal.org> <4108CDE4-7668-4312-AFAA-18DEEA58B33F@rocktreesky.com> Message-ID: <4A6DC307.8070108@poplarware.com> I can't make it to Friday's meeting, sorry! If there are tasks identified at the meeting that need people to take them on, please post them somewhere (and let us know where, if it's not in the Issue Queue, which I check regularly anyway). I should have some time to take some on in the next few weeks. Cheers, Jennifer -- Jennifer Hodgdon * Poplar ProductivityWare www.poplarware.com Drupal, WordPress, and custom Web programming From pwolanin at gmail.com Thu Jul 30 23:42:27 2009 From: pwolanin at gmail.com (Peter Wolanin) Date: Thu, 30 Jul 2009 19:42:27 -0400 Subject: [documentation] [security] [Security issue] Writing secure code case studies... In-Reply-To: <20090729220410.A95C116B4E2@www1.drupal.org> References: <20090729220410.A95C116B4E2@www1.drupal.org> Message-ID: <2247a8a70907301642pd0c9388p3b2c37f7f5d81ec1@mail.gmail.com> Hi Duncan, There is a "maintainers newsletter" which already exists and might be a good place for this. That newsletter has not gotten much love or content, so perhaps you can join in and help get it out more regularly? Here are past issues, and you shoudl be able to subscribe (or are force-subscribed if you're a module maintainer) http://drupal.org/forum/118 There is a group for newsletters here: http://groups.drupal.org/drupal-newsletter You might also get so volunteers at http://groups.drupal.org/coding-standards-and-best-practices -Peter On Wed, Jul 29, 2009 at 6:04 PM, wrote: > dbabbage sent a message using the contact form at http://drupal.org/contact. > > Hi there, > Have selected "security issue" as this is a suggestion for the security > team?apologies if this means it is escalated inappropriately. > > I'm contacting you to suggest the idea of a security newsletter that > presents case studies on how to write secure code. One of the great things > about the Drupal community is that it provides a welcoming entry point for > people new to development like myself. We have been using Drupal a while, we > then write a few patches, we contribute a bit more substantially to a > module, we write a module of our own, we end up porting another modules to a > newer version of Drupal and then ultimately take over the maintaining them > too, we start to submit core patches. (This describes my entry to the > community anyway.) We may have read the "writing secure code" guidelines, > and certainly intend to write secure code, but we may or may not have taken > it *all* in and may unknowingly have sometimes not followed the guidelines. > > I subscribe to the security announcements, and I often think I could > probably learn something useful by examining a diff of the fixed vs. > previous versions of the modules that had security issues?but I've never > gotten around to doing it. So I'd like to suggest that a email newsletter > could from time to time present examples of insecure code that was found in > a module, a short explanation of what made it insecure, and sample code with > an explanation of how it was fixed. I think less experienced developers > could learn a lot. > > Probably this would need to be a separate subscription to the main security > announcements list, because some people wouldn't want it?but I'd certainly > subscribe. > Cheers, > Duncan > -- > [ Security | http://lists.drupal.org/listinfo/security ] > From nan_wich at bellsouth.net Fri Jul 31 01:06:19 2009 From: nan_wich at bellsouth.net (nan_wich at bellsouth.net) Date: Fri, 31 Jul 2009 01:06:19 +0000 Subject: [documentation] [security] [Security issue] Writing secure codecase studies... In-Reply-To: <2247a8a70907301642pd0c9388p3b2c37f7f5d81ec1@mail.gmail.com> References: <20090729220410.A95C116B4E2@www1.drupal.org> <2247a8a70907301642pd0c9388p3b2c37f7f5d81ec1@mail.gmail.com> Message-ID: <073120090106.8759.4A72438A000F07100000223722228869349B0A02D2089B9A019C04040A0DBF080C0799A1020E02@att.net> Hmm... I didn't know there was a maintainers' newsletter. What is it's intended audience? Since I have 20+ modules, it might be a good thing for me. @Duncan: I understand and appreciate your desire to see examples of unsafe code, but such a thing could seem embarassing to those who were reported for it. Even on security issues I find on my own modules, I would be embarrassed to have them publicly displayed. (Peter, I bet you can think of a recent example.) Perhaps an aggregate of recent issues, suitably disguised, would work. -- Nancy E. Wichmann, PMP Injustice anywhere is a threat to justice everywhere. -- Dr. Martin L. King, Jr. -------------- next part -------------- An HTML attachment was scrubbed... URL: -------------- next part -------------- A non-text attachment was scrubbed... Name: not available Type: image/gif Size: 4752 bytes Desc: spring_01.gif URL: