From drupal at rocktreesky.com Thu Oct 2 16:44:51 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 2 Oct 2008 12:44:51 -0400 Subject: [documentation] Schedule October IRC meeting In-Reply-To: <63FB03E6-618E-469B-91CC-7F32ADEE11C5@rocktreesky.com> References: <63FB03E6-618E-469B-91CC-7F32ADEE11C5@rocktreesky.com> Message-ID: OK the Doodle was pretty clear on this one. ;-) The next IRC meeting will be Friday, October 10 at 16:00 GMT (18:00 CET, noon EDT, 9am PDT) in the #drupal-docs channel on the Freenode network. It will last for one hour. If you would like an email reminder before the meeting starts, you can sign up on the g.d.o event: http://groups.drupal.org/node/15515 . - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com On Sep 29, 2008, at 10:57 AM, Addison Berry wrote: > Hello all, > > Now that the Getting Involved book is started up, I wanted to set up > a time for the next IRC meeting. Let' s shoot for something next > week with the top agenda items being: > > 1. Wrap up discussion on Getting Involved. I hope we get a fair bit > of cleanup done during this week but we should touch on important > remaining items, if there are any. > 2. Talk about opening the editing rights up. Two helper issues we > wanted are now done and so we need to just get our ducks in a row > before we flip the switch. We can talk about what ducks need > ordering, what the change entails for the team and set a firm date. > > Here is ye old doodle to pick a time: http://www.doodle.ch/2rgcqb6tmmik2yck > > - Addi (add1sun) > > > > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081002/3def37ed/attachment.htm From drupal at rocktreesky.com Thu Oct 9 20:51:20 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 9 Oct 2008 16:51:20 -0400 Subject: [documentation] REMINDER: meeting Oct. 10 at 16:00 GMT In-Reply-To: References: <63FB03E6-618E-469B-91CC-7F32ADEE11C5@rocktreesky.com> Message-ID: <5B9A4E95-0ADC-4B16-A56F-82DF20DE7FA9@rocktreesky.com> Just a reminder that the next meeting is tomorrow at 16"00 GMT. :-) See ya'll there. On Oct 2, 2008, at 12:44 PM, Addison Berry wrote: > OK the Doodle was pretty clear on this one. ;-) The next IRC meeting > will be Friday, October 10 at 16:00 GMT (18:00 CET, noon EDT, 9am > PDT) in the #drupal-docs channel on the Freenode network. It will > last for one hour. If you would like an email reminder before the > meeting starts, you can sign up on the g.d.o event: http://groups.drupal.org/node/15515 > . > > - Addi (add1sun) > -------------------------------------- > Join us at Do It With Drupal! > A large scale, curated education event > December 10-12, New Orleans > http://www.doitwithdrupal.com > > > On Sep 29, 2008, at 10:57 AM, Addison Berry wrote: > >> Hello all, >> >> Now that the Getting Involved book is started up, I wanted to set >> up a time for the next IRC meeting. Let' s shoot for something next >> week with the top agenda items being: >> >> 1. Wrap up discussion on Getting Involved. I hope we get a fair bit >> of cleanup done during this week but we should touch on important >> remaining items, if there are any. >> 2. Talk about opening the editing rights up. Two helper issues we >> wanted are now done and so we need to just get our ducks in a row >> before we flip the switch. We can talk about what ducks need >> ordering, what the change entails for the team and set a firm date. >> >> Here is ye old doodle to pick a time: http://www.doodle.ch/2rgcqb6tmmik2yck >> >> - Addi (add1sun) >> >> >> >> >> >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081009/02e5fd2d/attachment.htm From drupal at rocktreesky.com Sat Oct 11 15:17:22 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Sat, 11 Oct 2008 11:17:22 -0400 Subject: [documentation] Summary of the Oct. 10 IRC meeting Message-ID: I've posted a summary of the meeting on the group site: http://groups.drupal.org/node/15796 and the log is at http://pastebin.com/f575075de Also note that you can see the past events and any minutes/summaries posted (starting with the last meeting) under the group Events tab: http://groups.drupal.org/node/14492/events Thanks to all who came and kept it rolling. :-) - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com From lee.hunter at hum.com Sun Oct 12 01:58:42 2008 From: lee.hunter at hum.com (Lee Hunter) Date: Sat, 11 Oct 2008 21:58:42 -0400 Subject: [documentation] Moving directory Message-ID: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> I stumbled across this directory buried in the writing secure code section of the Developing for Drupal guide: Configuration Steps For a More Secure Site http://drupal.org/node/244636 As far as I can see, this content is much more aimed at administrators than developers. Furthermore, it talks about things that need to be done long before anyone gets to the state where they are writing code. Would anyone object if I moved it to the Best Practices (http://drupal.org/best-practices) area of the Getting Started Guide? Lee Hunter Senior Technical Editor From wolf.zirbs at gmail.com Sun Oct 12 03:14:14 2008 From: wolf.zirbs at gmail.com (Wolf Zirbs) Date: Sun, 12 Oct 2008 05:14:14 +0200 Subject: [documentation] Moving directory In-Reply-To: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> Message-ID: +1 for me. It's definitly more suited for "Best Practices" Section. On Sun, Oct 12, 2008 at 3:58 AM, Lee Hunter wrote: > I stumbled across this directory buried in the writing secure code > section of the Developing for Drupal guide: > > Configuration Steps For a More Secure Site > http://drupal.org/node/244636 > > As far as I can see, this content is much more aimed at administrators > than developers. Furthermore, it talks about things that need to be > done long before anyone gets to the state where they are writing code. > > Would anyone object if I moved it to the Best Practices > (http://drupal.org/best-practices) area of the Getting Started Guide? > > Lee Hunter > Senior Technical Editor > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -- Sincerely Best Regards Wolf J. Zirbs P.S. You may contact me by Mobil - Handy between 10am and 10pm Vienna Local Time (+43 676 9286735) -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/3717057c/attachment.htm From john at noceda.net Sun Oct 12 03:12:05 2008 From: john at noceda.net (john at noceda.net) Date: Sat, 11 Oct 2008 22:12:05 -0500 Subject: [documentation] Moving directory In-Reply-To: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> Message-ID: <6f5dec73f307dc9987cedbbbd0291107@noceda.net> By all means! IMHO, the "Best Practices" area of the "Getting Started Guide" is the best area for the "Configuration Steps For a More Secure Site" section. John On Sat, 11 Oct 2008 21:58:42 -0400, "Lee Hunter" wrote: > I stumbled across this directory buried in the writing secure code > section of the Developing for Drupal guide: > > Configuration Steps For a More Secure Site > http://drupal.org/node/244636 > > As far as I can see, this content is much more aimed at administrators > than developers. Furthermore, it talks about things that need to be > done long before anyone gets to the state where they are writing code. > > Would anyone object if I moved it to the Best Practices > (http://drupal.org/best-practices) area of the Getting Started Guide? > > Lee Hunter > Senior Technical Editor > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ From gustavo.joaquin at gmail.com Sun Oct 12 12:59:18 2008 From: gustavo.joaquin at gmail.com (Gustavo Gonzalez) Date: Sun, 12 Oct 2008 10:59:18 -0200 Subject: [documentation] suscribe Message-ID: <7f8335330810120559h729c925avafca68b132765ca1@mail.gmail.com> -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/7d4b4013/attachment.htm From lee.hunter at hum.com Sun Oct 12 13:50:32 2008 From: lee.hunter at hum.com (Lee Hunter) Date: Sun, 12 Oct 2008 09:50:32 -0400 Subject: [documentation] Moving directory In-Reply-To: <6f5dec73f307dc9987cedbbbd0291107@noceda.net> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> Message-ID: <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> Ok I've moved that section to Best Practices. I wanted to note, though, that I'm still not entirely happy with where I had to put it. We've got other information about hosting in how to's, some in FAQs, some in tutorials etc. There really should be something like an Installation and Hosting Guide which pulls together all this information (and serves as the container for the D5, D6 installation etc.) Lee Hunter Senior Technical Editor On Sat, Oct 11, 2008 at 11:12 PM, wrote: > By all means! IMHO, the "Best Practices" area of the "Getting Started > Guide" is the best area for the "Configuration Steps For a More Secure > Site" section. > > John > > On Sat, 11 Oct 2008 21:58:42 -0400, "Lee Hunter" > wrote: >> I stumbled across this directory buried in the writing secure code >> section of the Developing for Drupal guide: >> >> Configuration Steps For a More Secure Site >> http://drupal.org/node/244636 >> >> As far as I can see, this content is much more aimed at administrators >> than developers. Furthermore, it talks about things that need to be >> done long before anyone gets to the state where they are writing code. >> >> Would anyone object if I moved it to the Best Practices >> (http://drupal.org/best-practices) area of the Getting Started Guide? >> >> Lee Hunter >> Senior Technical Editor >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From drupal at rocktreesky.com Sun Oct 12 14:47:39 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 12 Oct 2008 10:47:39 -0400 Subject: [documentation] Handbook reorganization was: Moving directory In-Reply-To: <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> Message-ID: <923C7499-42D0-42AF-A85C-6B4458A35387@rocktreesky.com> Hm, yes, well the entire Getting Started guide is the next major project on my personal hit list. Lee, could you sketch out an outline of a new organization for the Installation and Hosting so we can start tossing it around the team? I'd be most appreciative. I should also note that there is a similar movement afoot for the Theming guides too. ;-)http://drupal.org/node/317357 I'm going to chat with the redesign team on how much, if at all, MBD will be looking at IA *inside* the docs and how we can best coordinate that. I have a meeting with the redesign team on Tuesday and we are opening editing rights for all users on Wednesday, so once I get my head settled from all that, I'll report back to the team and we can figure out our next moves. In the meantime, please feel free to sketch up outlines (or compile old suggestions from old issues, etc.). Perhaps we can look at setting up things like surveys and cardsorts as well, but let me chat with redesign before we get carried away on duplicative work. - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com On Oct 12, 2008, at 9:50 AM, Lee Hunter wrote: > Ok I've moved that section to Best Practices. > > I wanted to note, though, that I'm still not entirely happy with where > I had to put it. We've got other information about hosting in how > to's, some in FAQs, some in tutorials etc. There really should be > something like an Installation and Hosting Guide which pulls together > all this information (and serves as the container for the D5, D6 > installation etc.) > > Lee Hunter > Senior Technical Editor > > On Sat, Oct 11, 2008 at 11:12 PM, wrote: >> By all means! IMHO, the "Best Practices" area of the "Getting Started >> Guide" is the best area for the "Configuration Steps For a More >> Secure >> Site" section. >> >> John >> >> On Sat, 11 Oct 2008 21:58:42 -0400, "Lee Hunter" >> wrote: >>> I stumbled across this directory buried in the writing secure code >>> section of the Developing for Drupal guide: >>> >>> Configuration Steps For a More Secure Site >>> http://drupal.org/node/244636 >>> >>> As far as I can see, this content is much more aimed at >>> administrators >>> than developers. Furthermore, it talks about things that need to be >>> done long before anyone gets to the state where they are writing >>> code. >>> >>> Would anyone object if I moved it to the Best Practices >>> (http://drupal.org/best-practices) area of the Getting Started >>> Guide? >>> >>> Lee Hunter >>> Senior Technical Editor >>> -- >>> Pending work: http://drupal.org/project/issues/documentation/ >>> List archives: http://lists.drupal.org/pipermail/documentation/ >> >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ >> > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/c63dd70d/attachment-0001.htm From drupal at rocktreesky.com Sun Oct 12 15:12:43 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Sun, 12 Oct 2008 11:12:43 -0400 Subject: [documentation] Handbook reorganization was: Moving directory In-Reply-To: <923C7499-42D0-42AF-A85C-6B4458A35387@rocktreesky.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <923C7499-42D0-42AF-A85C-6B4458A35387@rocktreesky.com> Message-ID: <9303405A-A163-49D5-B367-00BD7C14F590@rocktreesky.com> Also, BTW, here is Lee's initial stab at this discussion a year ago. http://drupal.org/node/199388 - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com On Oct 12, 2008, at 10:47 AM, Addison Berry wrote: > Hm, yes, well the entire Getting Started guide is the next major > project on my personal hit list. Lee, could you sketch out an > outline of a new organization for the Installation and Hosting so we > can start tossing it around the team? I'd be most appreciative. > > I should also note that there is a similar movement afoot for the > Theming guides too. ;-)http://drupal.org/node/317357 > > I'm going to chat with the redesign team on how much, if at all, MBD > will be looking at IA *inside* the docs and how we can best > coordinate that. I have a meeting with the redesign team on Tuesday > and we are opening editing rights for all users on Wednesday, so > once I get my head settled from all that, I'll report back to the > team and we can figure out our next moves. In the meantime, please > feel free to sketch up outlines (or compile old suggestions from old > issues, etc.). Perhaps we can look at setting up things like surveys > and cardsorts as well, but let me chat with redesign before we get > carried away on duplicative work. > > > - Addi (add1sun) > -------------------------------------- > Join us at Do It With Drupal! > A large scale, curated education event > December 10-12, New Orleans > http://www.doitwithdrupal.com > On Oct 12, 2008, at 9:50 AM, Lee Hunter wrote: > >> Ok I've moved that section to Best Practices. >> >> I wanted to note, though, that I'm still not entirely happy with >> where >> I had to put it. We've got other information about hosting in how >> to's, some in FAQs, some in tutorials etc. There really should be >> something like an Installation and Hosting Guide which pulls together >> all this information (and serves as the container for the D5, D6 >> installation etc.) >> >> Lee Hunter >> Senior Technical Editor >> >> On Sat, Oct 11, 2008 at 11:12 PM, wrote: >>> By all means! IMHO, the "Best Practices" area of the "Getting >>> Started >>> Guide" is the best area for the "Configuration Steps For a More >>> Secure >>> Site" section. >>> >>> John >>> >>> On Sat, 11 Oct 2008 21:58:42 -0400, "Lee Hunter" >>> >>> wrote: >>>> I stumbled across this directory buried in the writing secure code >>>> section of the Developing for Drupal guide: >>>> >>>> Configuration Steps For a More Secure Site >>>> http://drupal.org/node/244636 >>>> >>>> As far as I can see, this content is much more aimed at >>>> administrators >>>> than developers. Furthermore, it talks about things that need to be >>>> done long before anyone gets to the state where they are writing >>>> code. >>>> >>>> Would anyone object if I moved it to the Best Practices >>>> (http://drupal.org/best-practices) area of the Getting Started >>>> Guide? >>>> >>>> Lee Hunter >>>> Senior Technical Editor >>>> -- >>>> Pending work: http://drupal.org/project/issues/documentation/ >>>> List archives: http://lists.drupal.org/pipermail/documentation/ >>> >>> -- >>> Pending work: http://drupal.org/project/issues/documentation/ >>> List archives: http://lists.drupal.org/pipermail/documentation/ >>> >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/0a01e487/attachment.htm From wolf.zirbs at gmail.com Sun Oct 12 15:15:04 2008 From: wolf.zirbs at gmail.com (Wolf Zirbs) Date: Sun, 12 Oct 2008 17:15:04 +0200 Subject: [documentation] Moving directory In-Reply-To: <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> Message-ID: With all respect Lee, Seeing it from the point of view of a beginner that lands on the support page, in FAQs he would definitely want to see general Information in How-to's he would want to get some help in the basics of Drupal functionalities in Best Practice he will find more complex and technical information on Drupal Site implementation. I have to premise that I had not read and go throughout all the mentioned Sections So this is just an intuitive suggestion. Cheers On Sun, Oct 12, 2008 at 3:50 PM, Lee Hunter wrote: > Ok I've moved that section to Best Practices. > > I wanted to note, though, that I'm still not entirely happy with where > I had to put it. We've got other information about hosting in how > to's, some in FAQs, some in tutorials etc. There really should be > something like an Installation and Hosting Guide which pulls together > all this information (and serves as the container for the D5, D6 > installation etc.) > > Lee Hunter > Senior Technical Editor > > On Sat, Oct 11, 2008 at 11:12 PM, wrote: > > By all means! IMHO, the "Best Practices" area of the "Getting Started > > Guide" is the best area for the "Configuration Steps For a More Secure > > Site" section. > > > > John > > > > On Sat, 11 Oct 2008 21:58:42 -0400, "Lee Hunter" > > wrote: > >> I stumbled across this directory buried in the writing secure code > >> section of the Developing for Drupal guide: > >> > >> Configuration Steps For a More Secure Site > >> http://drupal.org/node/244636 > >> > >> As far as I can see, this content is much more aimed at administrators > >> than developers. Furthermore, it talks about things that need to be > >> done long before anyone gets to the state where they are writing code. > >> > >> Would anyone object if I moved it to the Best Practices > >> (http://drupal.org/best-practices) area of the Getting Started Guide? > >> > >> Lee Hunter > >> Senior Technical Editor > >> -- > >> Pending work: http://drupal.org/project/issues/documentation/ > >> List archives: http://lists.drupal.org/pipermail/documentation/ > > > > -- > > Pending work: http://drupal.org/project/issues/documentation/ > > List archives: http://lists.drupal.org/pipermail/documentation/ > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -- Sincerely Best Regards Wolf J. Zirbs Drupal.org Site Maintainer P.S. You may contact me by Mobil - Handy between 10am and 10pm Austria Vienna Local Time(GMT) (+43 676 9286735) -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/0ca4862f/attachment.htm From lee.hunter at hum.com Sun Oct 12 15:51:35 2008 From: lee.hunter at hum.com (Lee Hunter) Date: Sun, 12 Oct 2008 11:51:35 -0400 Subject: [documentation] Moving directory In-Reply-To: References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> Message-ID: <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> I actually think we've gone down the wrong track with these kind of headings. I call them "mystery headings" because they don't offer any indication of the actual content they contain. "Theme Guide" works well as a heading because it's clear that I'm going to find information about theming. On the other hand, "Howto", "Tutorial", "FAQ", "Best Practices" etc are all poor headings because they are so vague and meaningless that they can, and do, address any topic under the sun including theming, installation, hosting, development, using modules, etc. Any time I go to the documentation, I go there to address a very specific problem. For example, if I'm trying to get my server set up properly, I'd want to see all the server stuff in one place (under a heading that clearly tells me that it's server stuff) and see it presented in a logical order, according to task. Since the hosting configuration stuff is scattered all over the place, I have to go to "Howtos" to see if someone has written a howto, then go to "FAQs" to find out if there's a FAQ, then go to "Tutorials" to see if there's a server tutorial, then go to "Best Practices" to see if maybe there's a server best practice and even then I'm not sure if there might be more information hiding elsewhere. Lee Hunter Senior Technical Editor On Sun, Oct 12, 2008 at 11:15 AM, Wolf Zirbs wrote: > With all respect Lee, Seeing it from the point of view of a beginner that > lands on the support page, > in FAQs he would definitely want to see general Information > in How-to's he would want to get some help in the basics of Drupal > functionalities > in Best Practice he will find more complex and technical information on > Drupal Site implementation. > I have to premise that I had not read and go throughout all the mentioned > Sections From emmajane at xtrinsic.com Sun Oct 12 15:55:50 2008 From: emmajane at xtrinsic.com (Emma Jane Hogbin) Date: Sun, 12 Oct 2008 11:55:50 -0400 Subject: [documentation] Moving directory In-Reply-To: <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> Message-ID: <48F21E06.20808@xtrinsic.com> Lee Hunter wrote: > "Theme Guide" works well as a heading because it's clear that I'm > going to find information about theming. On the other hand, "Howto", > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because > they are so vague and meaningless that they can, and do, address any > topic under the sun including theming, installation, hosting, > development, using modules, etc. I have to throw in my +1 here. I have a strong dislike for documentation that is sorted by "type" of documentation rather than "content" of documentation. Of course if there was a link at the bottom of the page that said, "see this as a ____ format ____" for different learning styles that would be super awesome. regards, emma -- Emma Jane Hogbin, B.Sc. Founder, xtrinsic phone: (519) 371-2665 web: www.xtrinsic.com From drupal at ryancross.com Sun Oct 12 16:07:01 2008 From: drupal at ryancross.com (Ryan Cross) Date: Mon, 13 Oct 2008 03:07:01 +1100 Subject: [documentation] Moving directory In-Reply-To: <48F21E06.20808@xtrinsic.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> <48F21E06.20808@xtrinsic.com> Message-ID: <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> The real problem is that you need to address the documentation on several different levels. - Topical - Type (learning style, audience, etc) - Version (especially important as we continue to expand our maintenance of more versions) - (and potentially quality, completeness, etc) Plus, not everyone goes to the documentation for a specific question / reference which requires good random/non-sequential access. Other people also want to be able to read documentation in a logical sequential order. Throughout my experience with Drupal I have found need to locate documentation on all these levels. On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin wrote: > Lee Hunter wrote: > > "Theme Guide" works well as a heading because it's clear that I'm > > going to find information about theming. On the other hand, "Howto", > > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because > > they are so vague and meaningless that they can, and do, address any > > topic under the sun including theming, installation, hosting, > > development, using modules, etc. > > I have to throw in my +1 here. I have a strong dislike for documentation > that is sorted by "type" of documentation rather than "content" of > documentation. Of course if there was a link at the bottom of the page > that said, "see this as a ____ format ____" for different learning > styles that would be super awesome. > > > regards, > emma > > -- > Emma Jane Hogbin, B.Sc. > Founder, xtrinsic > phone: (519) 371-2665 > web: www.xtrinsic.com > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081013/c2f734fe/attachment.htm From wolf.zirbs at gmail.com Sun Oct 12 16:24:10 2008 From: wolf.zirbs at gmail.com (Wolf Zirbs) Date: Sun, 12 Oct 2008 18:24:10 +0200 Subject: [documentation] Moving directory In-Reply-To: <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> <48F21E06.20808@xtrinsic.com> <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> Message-ID: @A I know this is an old story, organizing documentation, allow me to say that a summary table (like SiteMap) would really be of help. My efforts to get as much deeply in the "Drupal.org Handbooks" structure did bring me first to learn to understand "TERMS" (I'm no native English) and collect them in Common expressions & acronyms used on D.O. wich help me (and hopefully all) to find what I'm looking for. It will take more time for me to build from that from me so called "Index-page" an orientation resource that will bring me suddenly what I'm looking for. I understand that even myself tend to unconsciously have preferences to some sections because it's the actual theme I'm working on, this is why an "Index-page" or Table would satisfy neutrally all orientations and search preferences. On Sun, Oct 12, 2008 at 6:07 PM, Ryan Cross wrote: > The real problem is that you need to address the documentation on several > different levels. > > - Topical > - Type (learning style, audience, etc) > - Version (especially important as we continue to expand our maintenance of > more versions) > - (and potentially quality, completeness, etc) > > Plus, not everyone goes to the documentation for a specific question / > reference which requires good random/non-sequential access. Other people > also want to be able to read documentation in a logical sequential order. > > Throughout my experience with Drupal I have found need to locate > documentation on all these levels. > > > > On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin wrote: > >> Lee Hunter wrote: >> > "Theme Guide" works well as a heading because it's clear that I'm >> > going to find information about theming. On the other hand, "Howto", >> > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because >> > they are so vague and meaningless that they can, and do, address any >> > topic under the sun including theming, installation, hosting, >> > development, using modules, etc. >> >> I have to throw in my +1 here. I have a strong dislike for documentation >> that is sorted by "type" of documentation rather than "content" of >> documentation. Of course if there was a link at the bottom of the page >> that said, "see this as a ____ format ____" for different learning >> styles that would be super awesome. >> >> >> regards, >> emma >> >> -- >> Emma Jane Hogbin, B.Sc. >> Founder, xtrinsic >> phone: (519) 371-2665 >> web: www.xtrinsic.com >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ >> > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -- Sincerely Best Regards Wolf J. Zirbs Drupal.org Site Maintainer Blog http://wolf.zirbs.garschagen.at -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081012/c02c714c/attachment.htm From lee.hunter at hum.com Sun Oct 12 17:14:40 2008 From: lee.hunter at hum.com (Lee Hunter) Date: Sun, 12 Oct 2008 13:14:40 -0400 Subject: [documentation] Moving directory In-Reply-To: <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> <48F21E06.20808@xtrinsic.com> <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> Message-ID: <197f52f50810121014r4092166cgcacab13c80ef1436@mail.gmail.com> I agree that there are different needs, different approaches to learning, and different valid conceptions of what an ideal structure might be. Added to that there is the complication that a single page of the documentation might contain information that is relevant to several different areas (a page might touch on theming, development, and snippets). That's why I wrote a few weeks ago that a hierarchical tagging approach, similar to Wikipedia categories, along with the Faceted Search module might be very useful in that it would allow us to create multiple pathways. You could get to the same page from both the theming track, the developing track or the "how to" track if it happened to be relevant to all three. Having said that, if we continue to use a standard heading/subheading approach, the status quo is by far the most generally unhelpful model because the headings do everything to obscure, and nothing to reveal, the underlying content. They also tend to encourage the duplication of content and they make it nearly impossible to find everything related to a particular subject. Lee Hunter Senior Technical Editor On Sun, Oct 12, 2008 at 12:07 PM, Ryan Cross wrote: > The real problem is that you need to address the documentation on several > different levels. > > - Topical > - Type (learning style, audience, etc) > - Version (especially important as we continue to expand our maintenance of > more versions) > - (and potentially quality, completeness, etc) > > Plus, not everyone goes to the documentation for a specific question / > reference which requires good random/non-sequential access. Other people > also want to be able to read documentation in a logical sequential order. > > Throughout my experience with Drupal I have found need to locate > documentation on all these levels. > > > > On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin > wrote: >> >> Lee Hunter wrote: >> > "Theme Guide" works well as a heading because it's clear that I'm >> > going to find information about theming. On the other hand, "Howto", >> > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because >> > they are so vague and meaningless that they can, and do, address any >> > topic under the sun including theming, installation, hosting, >> > development, using modules, etc. >> >> I have to throw in my +1 here. I have a strong dislike for documentation >> that is sorted by "type" of documentation rather than "content" of >> documentation. Of course if there was a link at the bottom of the page >> that said, "see this as a ____ format ____" for different learning >> styles that would be super awesome. >> >> >> regards, >> emma >> >> -- >> Emma Jane Hogbin, B.Sc. >> Founder, xtrinsic >> phone: (519) 371-2665 >> web: www.xtrinsic.com >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From drupal at rocktreesky.com Tue Oct 14 18:07:55 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Tue, 14 Oct 2008 14:07:55 -0400 Subject: [documentation] Opening editing rights tomorrow, Oct 15 Message-ID: As discussed at last Friday's IRC meeting and posted to the list (http://groups.drupal.org/node/15796 ), we'll be turning on edit rights for all authenticated users on d.o tomorrow, October 15. We have a draft announcement for the front page, so please feel free to help edit/review it: http://drupal.org/node/310912#comment-1057861 I also want to remind everyone that we have a direct link to the Diffs for recent updates in the handbook (http://drupal.org/handbook/ updates). (There is a direct link to this page in the Documentation team links block.) We should all try to spend a few minutes a day keeping an eye on the updates and see how things go. Documentation team members will have permissions to revert to earlier revisions so if someone really made a real mess of things feel free to pull the revert trigger. Thanks to everyone that has been working hard to get ready for this. - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com From sepeck at gmail.com Tue Oct 14 20:59:25 2008 From: sepeck at gmail.com (Steven Peck) Date: Tue, 14 Oct 2008 13:59:25 -0700 Subject: [documentation] Moving directory In-Reply-To: <197f52f50810121014r4092166cgcacab13c80ef1436@mail.gmail.com> References: <197f52f50810111858h498aa4c9tdebac5a871fb14a4@mail.gmail.com> <6f5dec73f307dc9987cedbbbd0291107@noceda.net> <197f52f50810120650x1560c0cdofa4059009722b753@mail.gmail.com> <197f52f50810120851q585edb2aj1a209ac00f3e7e84@mail.gmail.com> <48F21E06.20808@xtrinsic.com> <4e983be00810120907o1bcc53d9w6d3f1d1b6a3ba94@mail.gmail.com> <197f52f50810121014r4092166cgcacab13c80ef1436@mail.gmail.com> Message-ID: I want to mention something real quick. The Getting Started guide was meant to be just that. Getting started with core Drupal for new people. Nothing more. It was not a catch all for advance stuff. There are concept articles that it would benefit from, but really, it was a high level over view of the project, history and get people off the ground. There is so much to do/learn that it was focused on getting people to that point. It has a secondary purpose. An achievable target to be upgraded when a new version of Drupal is released. Do please keep that in mind when looking at the books and considering re-organizations. Steven On Sun, Oct 12, 2008 at 10:14 AM, Lee Hunter wrote: > I agree that there are different needs, different approaches to > learning, and different valid conceptions of what an ideal structure > might be. Added to that there is the complication that a single page > of the documentation might contain information that is relevant to > several different areas (a page might touch on theming, development, > and snippets). > > That's why I wrote a few weeks ago that a hierarchical tagging > approach, similar to Wikipedia categories, along with the Faceted > Search module might be very useful in that it would allow us to create > multiple pathways. You could get to the same page from both the > theming track, the developing track or the "how to" track if it > happened to be relevant to all three. > > Having said that, if we continue to use a standard heading/subheading > approach, the status quo is by far the most generally unhelpful model > because the headings do everything to obscure, and nothing to reveal, > the underlying content. They also tend to encourage the duplication of > content and they make it nearly impossible to find everything related > to a particular subject. > > Lee Hunter > Senior Technical Editor > > > On Sun, Oct 12, 2008 at 12:07 PM, Ryan Cross wrote: >> The real problem is that you need to address the documentation on several >> different levels. >> >> - Topical >> - Type (learning style, audience, etc) >> - Version (especially important as we continue to expand our maintenance of >> more versions) >> - (and potentially quality, completeness, etc) >> >> Plus, not everyone goes to the documentation for a specific question / >> reference which requires good random/non-sequential access. Other people >> also want to be able to read documentation in a logical sequential order. >> >> Throughout my experience with Drupal I have found need to locate >> documentation on all these levels. >> >> >> >> On Mon, Oct 13, 2008 at 2:55 AM, Emma Jane Hogbin >> wrote: >>> >>> Lee Hunter wrote: >>> > "Theme Guide" works well as a heading because it's clear that I'm >>> > going to find information about theming. On the other hand, "Howto", >>> > "Tutorial", "FAQ", "Best Practices" etc are all poor headings because >>> > they are so vague and meaningless that they can, and do, address any >>> > topic under the sun including theming, installation, hosting, >>> > development, using modules, etc. >>> >>> I have to throw in my +1 here. I have a strong dislike for documentation >>> that is sorted by "type" of documentation rather than "content" of >>> documentation. Of course if there was a link at the bottom of the page >>> that said, "see this as a ____ format ____" for different learning >>> styles that would be super awesome. >>> >>> >>> regards, >>> emma >>> >>> -- >>> Emma Jane Hogbin, B.Sc. >>> Founder, xtrinsic >>> phone: (519) 371-2665 >>> web: www.xtrinsic.com >>> -- >>> Pending work: http://drupal.org/project/issues/documentation/ >>> List archives: http://lists.drupal.org/pipermail/documentation/ >> >> >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ >> > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From drupal at rocktreesky.com Wed Oct 15 19:49:27 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Wed, 15 Oct 2008 15:49:27 -0400 Subject: [documentation] Opening editing rights tomorrow, Oct 15 In-Reply-To: References: Message-ID: <6FF4A7C4-B8BB-499A-A785-14A71B80A69B@rocktreesky.com> Just a heads-up that I am going to hold off and do this tomorrow, October 16, because Drupalcon just announced on the front page and I don' t want to knock them. I'll make the switch and put up the post tomorrow morning. - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com On Oct 14, 2008, at 2:07 PM, Addison Berry wrote: > As discussed at last Friday's IRC meeting and posted to the list (http://groups.drupal.org/node/15796 > ), we'll be turning on edit rights for all authenticated users on d.o > tomorrow, October 15. > > We have a draft announcement for the front page, so please feel free > to help edit/review it: http://drupal.org/node/310912#comment-1057861 > > I also want to remind everyone that we have a direct link to the Diffs > for recent updates in the handbook (http://drupal.org/handbook/ > updates). (There is a direct link to this page in the Documentation > team links block.) We should all try to spend a few minutes a day > keeping an eye on the updates and see how things go. Documentation > team members will have permissions to revert to earlier revisions so > if someone really made a real mess of things feel free to pull the > revert trigger. > > Thanks to everyone that has been working hard to get ready for this. > > - Addi (add1sun) > -------------------------------------- > Join us at Do It With Drupal! > A large scale, curated education event > December 10-12, New Orleans > http://www.doitwithdrupal.com > > > > > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081015/dde22443/attachment.htm From drupal at rocktreesky.com Fri Oct 17 14:31:40 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Fri, 17 Oct 2008 10:31:40 -0400 Subject: [documentation] Redesign discussion Message-ID: <1D3F1653-7A27-4695-8509-F9F7EEECE1C2@rocktreesky.com> I've put up a discussion-starter post on the Redesign group (cross- posted to the Docs group) about high-level doc redesign considerations. Please join the discussion and make wireframes. This is our opportunity to put it all on the table and pick a direction for some important aspects of docs. Thanks. http://groups.drupal.org/node/15965 - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com From jswami at pamho.net Sat Oct 18 10:45:17 2008 From: jswami at pamho.net (O Govinda) Date: Sat, 18 Oct 2008 03:45:17 -0700 (PDT) Subject: [documentation] "Handbook Style Guide": personal pronouns Message-ID: <20045855.post@talk.nabble.com> High-handedly, perhaps, in the Style Guide (at http://drupal.org/about/authoring) I've made this change: WAS: "Avoid using personal pronouns: I, my, we, our, etc." NOW: "Avoid using first-person pronouns: I, my, we, our, etc." This of course opens things up for the optional use of "you." If I'd wanted to be ultra high-handed I'd have added, "Feel free to address the reader as 'you.' " But perhaps that's something to be first agreed-on here. Best wishes, O Govinda -- View this message in context: http://www.nabble.com/%22Handbook-Style-Guide%22%3A-personal-pronouns-tp20045855p20045855.html Sent from the Drupal - Doc mailing list archive at Nabble.com. From dave.a.ingram at gmail.com Thu Oct 23 23:29:42 2008 From: dave.a.ingram at gmail.com (Dave Ingram) Date: Thu, 23 Oct 2008 19:29:42 -0400 Subject: [documentation] Drupal Taxonomy page Message-ID: <5467931c0810231629w2ee18a3fr5f076ef7c258f134@mail.gmail.com> I'm somewhat new to Drupal and the Taxonomy system was a bit confusing to me at first. I just did an overhaul of the Taxonomy page in the Getting Started handbook.. if anyone has any input on it I'd be grateful. Thanks, Dave -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081023/de8c722c/attachment.htm From drupal at rocktreesky.com Thu Oct 23 23:36:23 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 23 Oct 2008 19:36:23 -0400 Subject: [documentation] IRC meeting re: open editing and redesign Message-ID: Well, we have had open editing for a week now and so far so good as I have been watching. We should meet to talk about how our trial is going and whether we want to continue to keep it open or close back up. We can also talk about the state of the redesign. If you have other agenda items, feel free to add. Here is the doodle to schedule the meeting: http://www.doodle.com/667xykvs65hhyh5z - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081023/6bca6527/attachment.htm From shai at content2zero.com Mon Oct 27 15:27:18 2008 From: shai at content2zero.com (Shai Gluskin) Date: Mon, 27 Oct 2008 11:27:18 -0400 Subject: [documentation] project/usage page needs more advertising Message-ID: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> Hi gang, Before I submit an issue at the Webmasters queue, I thought I'd get your feedback. I just found out today about the existence of http://drupal.org/project/usage Wow, what a resource! I think it should really be advertised a LOT more. I'd propose some mention of it on the main module page: http://drupal.org/project/Modules Other ideas? Do people agree? [It does have a problem in that, from what I can tell, Drupal 5 sites that have the "Drupal" module turned off will not phone home. Many people think that the only thing the Drupal module does is allow registration with user accounts from other Drupal sites, which a lot of people want turned off. But even with that limitation the information is extremely valuable, and especially as D6 gets wider and wider acceptance where this feature is better handled.] Shai -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081027/fc47dcbc/attachment.htm From esmerel at logrus.com Mon Oct 27 15:44:06 2008 From: esmerel at logrus.com (Lynette) Date: Mon, 27 Oct 2008 08:44:06 -0700 Subject: [documentation] project/usage page needs more advertising In-Reply-To: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> References: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> Message-ID: <4905E1C6.6010100@logrus.com> It was announced.. friday? in #drupal. I think dww and webchick have a discussion going about it: http://drupal.org/node/325444 I dunno if you've seen that but I think that may cover what you're looking for =) - Lynette Shai Gluskin wrote: > Hi gang, > > Before I submit an issue at the Webmasters queue, I thought I'd get your > feedback. > > I just found out today about the existence of > http://drupal.org/project/usage > > Wow, what a resource! > > I think it should really be advertised a LOT more. I'd propose some > mention of it on the main module page: > http://drupal.org/project/Modules > > Other ideas? Do people agree? > > [It does have a problem in that, from what I can tell, Drupal 5 sites > that have the "Drupal" module turned off will not phone home. Many > people think that the only thing the Drupal module does is allow > registration with user accounts from other Drupal sites, which a lot of > people want turned off. But even with that limitation the information is > extremely valuable, and especially as D6 gets wider and wider acceptance > where this feature is better handled.] > > Shai > > > ------------------------------------------------------------------------ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ From scott at themountainaz.com Mon Oct 27 16:20:47 2008 From: scott at themountainaz.com (Scott McKinnis) Date: Mon, 27 Oct 2008 09:20:47 -0700 Subject: [documentation] project/usage page needs more advertising In-Reply-To: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> References: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> Message-ID: <7f3a377d0810270920y64c0541as1defb6bf9e957d6a@mail.gmail.com> That's pretty cool! I could see many different ways of using this page. Right up front (being the newb I am) I'd use it to see what modules are staying active and not headed out in the future. Maybe? Also I can actually *find* a module for download. In searching for a module I seem to find all modules associated with that module long before I can get to the module I actually I want. Scott McKinnis http://scottmckinnis.com/ INTEGRITY REALTY & ASSOCIATES. LLC On Mon, Oct 27, 2008 at 8:27 AM, Shai Gluskin wrote: > Hi gang, > > Before I submit an issue at the Webmasters queue, I thought I'd get your > feedback. > > I just found out today about the existence of > http://drupal.org/project/usage > > Wow, what a resource! > > I think it should really be advertised a LOT more. I'd propose some mention > of it on the main module page: > http://drupal.org/project/Modules > > Other ideas? Do people agree? > > [It does have a problem in that, from what I can tell, Drupal 5 sites that > have the "Drupal" module turned off will not phone home. Many people think > that the only thing the Drupal module does is allow registration with user > accounts from other Drupal sites, which a lot of people want turned off. But > even with that limitation the information is extremely valuable, and > especially as D6 gets wider and wider acceptance where this feature is > better handled.] > > Shai > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081027/55c4d239/attachment.htm From sepeck at gmail.com Mon Oct 27 17:55:36 2008 From: sepeck at gmail.com (Steven Peck) Date: Mon, 27 Oct 2008 10:55:36 -0700 Subject: [documentation] project/usage page needs more advertising In-Reply-To: <7f3a377d0810270920y64c0541as1defb6bf9e957d6a@mail.gmail.com> References: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> <7f3a377d0810270920y64c0541as1defb6bf9e957d6a@mail.gmail.com> Message-ID: That's the idea of it. It literally just got implemented. It's been in planning and development off and on for about a year now. I am finding some of the verbiage on the page a little obscure even for me but need to sit down and figure out if it's just me or what alternatives could be added. On Mon, Oct 27, 2008 at 9:20 AM, Scott McKinnis wrote: > That's pretty cool! I could see many different ways of using this page. > Right up front (being the newb I am) I'd use it to see what modules are > staying active and not headed out in the future. Maybe? Also I can actually > *find* a module for download. In searching for a module I seem to find all > modules associated with that module long before I can get to the module I > actually I want. > > Scott McKinnis > http://scottmckinnis.com/ > INTEGRITY REALTY & ASSOCIATES. LLC > > > On Mon, Oct 27, 2008 at 8:27 AM, Shai Gluskin wrote: >> >> Hi gang, >> >> Before I submit an issue at the Webmasters queue, I thought I'd get your >> feedback. >> >> I just found out today about the existence of >> http://drupal.org/project/usage >> >> Wow, what a resource! >> >> I think it should really be advertised a LOT more. I'd propose some >> mention of it on the main module page: >> http://drupal.org/project/Modules >> >> Other ideas? Do people agree? >> >> [It does have a problem in that, from what I can tell, Drupal 5 sites that >> have the "Drupal" module turned off will not phone home. Many people think >> that the only thing the Drupal module does is allow registration with user >> accounts from other Drupal sites, which a lot of people want turned off. But >> even with that limitation the information is extremely valuable, and >> especially as D6 gets wider and wider acceptance where this feature is >> better handled.] >> >> Shai >> >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From shai at content2zero.com Mon Oct 27 18:24:59 2008 From: shai at content2zero.com (Shai Gluskin) Date: Mon, 27 Oct 2008 14:24:59 -0400 Subject: [documentation] project/usage page needs more advertising In-Reply-To: References: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> <7f3a377d0810270920y64c0541as1defb6bf9e957d6a@mail.gmail.com> Message-ID: <9f68efb70810271124g49030a72r40f3a33d49ed9e58@mail.gmail.com> HI Gang, When I wrote the initial email, I didn't realize this had just been launched. Thanks Lynette for the link to the current discussion. Also, I put out some wrong information in my post. I said that for Drupal 5, the user stats are dependent on the "Drupal" module being turned on. That is not true. It is dependent on the Drupal 5 install having Update Status installed as a contrib module. Shai -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081027/6ec00246/attachment.htm From wolf.zirbs at gmail.com Mon Oct 27 21:32:34 2008 From: wolf.zirbs at gmail.com (Wolf Zirbs) Date: Mon, 27 Oct 2008 22:32:34 +0100 Subject: [documentation] project/usage page needs more advertising In-Reply-To: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> References: <9f68efb70810270827u12873988xff6c79dcc3a36ec8@mail.gmail.com> Message-ID: Thanks @Shai Gluskin for informing about this really interesting node. Thanks also to all who planned and implemented that View. I have started to provide some link to it from the nodes that may be related to. One link I have provide in the "Common Terminology" page (Common expressions & acronyms used on D.O. ) Kind Regards On Mon, Oct 27, 2008 at 4:27 PM, Shai Gluskin wrote: > Hi gang, > > Before I submit an issue at the Webmasters queue, I thought I'd get your > feedback. > > I just found out today about the existence of > http://drupal.org/project/usage > > Wow, what a resource! > > I think it should really be advertised a LOT more. I'd propose some mention > of it on the main module page: > http://drupal.org/project/Modules > > Other ideas? Do people agree? > > [It does have a problem in that, from what I can tell, Drupal 5 sites that > have the "Drupal" module turned off will not phone home. Many people think > that the only thing the Drupal module does is allow registration with user > accounts from other Drupal sites, which a lot of people want turned off. But > even with that limitation the information is extremely valuable, and > especially as D6 gets wider and wider acceptance where this feature is > better handled.] > > Shai > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -- Sincerely , Kind Regards Wolf J. Zirbs Drupal Documentation Team Member | Drupal.org Site Maintainer -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081027/7219db0a/attachment.htm From gabor at hojtsy.hu Wed Oct 29 22:37:59 2008 From: gabor at hojtsy.hu (=?ISO-8859-1?Q?G=E1bor_Hojtsy?=) Date: Wed, 29 Oct 2008 23:37:59 +0100 Subject: [documentation] Here comes the Features page! :) Message-ID: <86ca3ccb0810291537w443969f9gf5136202566ee574@mail.gmail.com> Hey, Up until earlier yesterday, the http://drupal.org/features page was managed by an obscure and old module called feature, which is used by less the 30 sites reporting back: http://drupal.org/project/usage/feature The permissions for editing this page were limited, so you could not get there, and even if you could, the module restricted you to its custom categories support (no, not taxonomy), and feature items in categories, which could only have some textual intro, an image link and a read more link. All managed in custom code stored in custom tables. Not totally flexible. This data was all used to generate what looks like very dated markup such as

General features

for a header and Collaborative Book - Our unique collaborative book feature lets you setup a "book" and then authorize other individuals to contribute content.
detailed information  for explanation. Ouch. It also linked to Drupal 4.3 screenshots as showcase. Due to the permissions and architecture limitations, this was deadly outdated. It also did not support versioning of the feature list, only supported plain text input in feature descriptions, no formatting whatsoever, etc. So what happened yesterday, is that this module was finally retired from drupal.org, and its generated page was moved into the node which made it possible to have it in the handbook, but magically did not contain any text before. Now the content is up for the doc team, and you should be able to run with it and update / spice it up, clean out old markup, etc. Please do! G?bor From drupal at rocktreesky.com Wed Oct 29 22:57:23 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Wed, 29 Oct 2008 18:57:23 -0400 Subject: [documentation] Here comes the Features page! :) In-Reply-To: <86ca3ccb0810291537w443969f9gf5136202566ee574@mail.gmail.com> References: <86ca3ccb0810291537w443969f9gf5136202566ee574@mail.gmail.com> Message-ID: <7E5DC0DD-0E9E-47AD-9150-7DDA9E47FD3A@rocktreesky.com> Just an FYI, this was still on Full HTML format due to whack HTML. I cleaned it up, stripping all of the junk out and making it suitable for the Doc team format, so it is now cleaner and accessible to doc team. It does indeed need more cleanup though. - Addi On Oct 29, 2008, at 6:37 PM, G?bor Hojtsy wrote: > Hey, > > Up until earlier yesterday, the http://drupal.org/features page was > managed by an obscure and old module called feature, which is used by > less the 30 sites reporting back: > http://drupal.org/project/usage/feature The permissions for editing > this page were limited, so you could not get there, and even if you > could, the module restricted you to its custom categories support (no, > not taxonomy), and feature items in categories, which could only have > some textual intro, an image link and a read more link. All managed in > custom code stored in custom tables. Not totally flexible. This data > was all used to generate what looks like very dated markup such as > >

General features

> > for a header and > > Collaborative Book - Our unique collaborative book feature > lets you setup a "book" and then authorize other individuals to > contribute content.
detailed > information  > > for explanation. Ouch. It also linked to Drupal 4.3 screenshots as > showcase. Due to the permissions and architecture limitations, this > was deadly outdated. It also did not support versioning of the feature > list, only supported plain text input in feature descriptions, no > formatting whatsoever, etc. > > So what happened yesterday, is that this module was finally retired > from > drupal.org, and its generated page was moved into the node which made > it possible to have it in the handbook, but magically did not contain > any text before. Now the content is up for the doc team, and you > should be able to run with it and update / spice it up, clean out old > markup, etc. Please do! > > G?bor > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ From shai at content2zero.com Thu Oct 30 04:14:33 2008 From: shai at content2zero.com (Shai Gluskin) Date: Thu, 30 Oct 2008 00:14:33 -0400 Subject: [documentation] Here comes the Features page! :) In-Reply-To: <7E5DC0DD-0E9E-47AD-9150-7DDA9E47FD3A@rocktreesky.com> References: <86ca3ccb0810291537w443969f9gf5136202566ee574@mail.gmail.com> <7E5DC0DD-0E9E-47AD-9150-7DDA9E47FD3A@rocktreesky.com> Message-ID: <9f68efb70810292114x4dcee717yc304520b78fd5b49@mail.gmail.com> Great work! Gabor and Addi Looks like there are special permissions for those features, mission, etc. pages. I'm not seeing and "edit" link when I'm on those pages. I'm pretty sure I'm on the docs team. But is there a "super docs team" permission or some such that you need to work on those pages. Shai On Wed, Oct 29, 2008 at 6:57 PM, Addison Berry wrote: > Just an FYI, this was still on Full HTML format due to whack HTML. I > cleaned it up, stripping all of the junk out and making it suitable > for the Doc team format, so it is now cleaner and accessible to doc > team. It does indeed need more cleanup though. > > - Addi > > On Oct 29, 2008, at 6:37 PM, G?bor Hojtsy wrote: > > > Hey, > > > > Up until earlier yesterday, the http://drupal.org/features page was > > managed by an obscure and old module called feature, which is used by > > less the 30 sites reporting back: > > http://drupal.org/project/usage/feature The permissions for editing > > this page were limited, so you could not get there, and even if you > > could, the module restricted you to its custom categories support (no, > > not taxonomy), and feature items in categories, which could only have > > some textual intro, an image link and a read more link. All managed in > > custom code stored in custom tables. Not totally flexible. This data > > was all used to generate what looks like very dated markup such as > > > >

General features

> > > > for a header and > > > > Collaborative Book - Our unique collaborative book feature > > lets you setup a "book" and then authorize other individuals to > > contribute content.
detailed > > information  > > > > for explanation. Ouch. It also linked to Drupal 4.3 screenshots as > > showcase. Due to the permissions and architecture limitations, this > > was deadly outdated. It also did not support versioning of the feature > > list, only supported plain text input in feature descriptions, no > > formatting whatsoever, etc. > > > > So what happened yesterday, is that this module was finally retired > > from > > drupal.org, and its generated page was moved into the node which made > > it possible to have it in the handbook, but magically did not contain > > any text before. Now the content is up for the doc team, and you > > should be able to run with it and update / spice it up, clean out old > > markup, etc. Please do! > > > > G?bor > > -- > > Pending work: http://drupal.org/project/issues/documentation/ > > List archives: http://lists.drupal.org/pipermail/documentation/ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081030/f208483a/attachment.htm From drupal at rocktreesky.com Thu Oct 30 15:34:00 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 30 Oct 2008 11:34:00 -0400 Subject: [documentation] Docs IRC meeting: Nov 7 References: <16343-0@groups.drupal.org> Message-ID: <18A10667-C6DF-4BE3-B2CC-5930EF5A2FCC@rocktreesky.com> > Event 'Docs IRC meeting: Nov 7' by add1sun > > Our next IRC meeting will be on Friday, November 7 at 17:00 GMT (Noon > EST, 9 a.m. PST). We will meet in the #drupal-docs channel on the > FreeNode network for one hour. > > > Agenda: > - Announcements > - Discuss the open editing experience. Is it working, should we > continue? Thoughts, improvements? > - Catch up on the D.o Redesign and how it is effecting docs > - Discuss next projects > > > Feel free to add to the agenda and discuss open editing prior to the > meeting on the docs mail list. > From drupal at rocktreesky.com Thu Oct 30 18:01:02 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 30 Oct 2008 14:01:02 -0400 Subject: [documentation] iCal of docs events Message-ID: Just a heads-up that Moshe did some troubleshooting on our event block problem on the g.d.o doc group page. Turns out g.d.o uses an older version of date module that has some issues with GMT timezones, so none of our events using that timezone (which I use on all of them except local events) just weren't showing. Moshe will work on updating g.d.o to the new version of date, but that will obviously take some testing and time. In the meantime I will post our events using US eastern timezone. We now have a functioning event block and you can grab an iCal feed of our events (link is on the Events block on the group page). Woot! and thanks to Moshe. :-) - Addi (add1sun) -------------------------------------- Join us at Do It With Drupal! A large scale, curated education event December 10-12, New Orleans http://www.doitwithdrupal.com