From erin at codeknitter.com Wed Dec 3 22:02:48 2008 From: erin at codeknitter.com (Erin Rasmussen) Date: Wed, 3 Dec 2008 14:02:48 -0800 (PST) Subject: [documentation] Bookmarking function? Message-ID: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> Hi, In the process of looking for solutions to my own drupal problems, and in looking at the drupal documentation. I find that I keep getting lost, and loosing track of stories that needed editing, or were otherwise interesting to me. A browser bookmark would be a great solution for me, except for the fact that I make my life more complicated by frequently working in a 'hot-seat' situation where i do the same job from multiple computers. Is there an online bookmarking system that I can use to help me keep track of drupal documentation? I know there are social bookmarking sites, are there any that any other documentation team members have found have particularly useful? (Additionally, and aside : would this sort of functionality help other users? It would be nice to log into the drupal site, and have my own set of bookmarks to play with). So - i guess it's sort of a support question, but since it directly relates to navigating the documentation pages I thought it may be a better idea to ask the question here. Thanks, Erin erin at codeknitter.com -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081203/fc171c52/attachment.htm From kristof at pronovix.com Wed Dec 3 22:35:41 2008 From: kristof at pronovix.com (Kristof Van Tomme) Date: Wed, 3 Dec 2008 23:35:41 +0100 Subject: [documentation] Bookmarking function? In-Reply-To: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> References: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> Message-ID: Hi Erin, I recently made a bookmarklet-knowledge management system-neontology mashup for drupal specific knowledge management. Maybe what you are looking for? check out my blogpost at: http://www.pronovix.com/solution/druplet-knowledge-management-system-drupal-built-drupal The system: -stores the interesting snippets from webpages with their context (e.g. URL) -does this almost full automatically (using a bookmarklet and some smart node referencing) -gives you related problems and their solutions -let's people build an RDF schema vocabulary from the knowledge tags people submit (e.g. this will get us a Drupal problem ontology) As we speak the druplet.org domain DNS is propagating it's still early development, but I'lld be happy to have you and some other folks from the doc list as testers ;) Cheers, Kristof 2008/12/3 Erin Rasmussen : > Hi, > In the process of looking for solutions to my own drupal problems, and in > looking at the drupal documentation. I find that I keep getting lost, and > loosing track of stories that needed editing, or were otherwise interesting > to me. > > A browser bookmark would be a great solution for me, except for the fact > that I make my life more complicated by frequently working in a 'hot-seat' > situation where i do the same job from multiple computers. > > Is there an online bookmarking system that I can use to help me keep track > of drupal documentation? I know there are social bookmarking sites, are > there any that any other documentation team members have found have > particularly useful? > > (Additionally, and aside : would this sort of functionality help other > users? It would be nice to log into the drupal site, and have my own set of > bookmarks to play with). > > So - i guess it's sort of a support question, but since it directly relates > to navigating the documentation pages I thought it may be a better idea to > ask the question here. > > Thanks, > Erin > erin at codeknitter.com > > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From forums at ipwa.net Wed Dec 3 22:43:12 2008 From: forums at ipwa.net (Nicolas Borda) Date: Wed, 3 Dec 2008 22:43:12 +0000 Subject: [documentation] Bookmarking function? In-Reply-To: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> References: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> Message-ID: <2019048D-80C8-49D9-876E-C14CCBEB777F@ipwa.net> On 3 Dec 2008, at 22:02, Erin Rasmussen wrote: > Is there an online bookmarking system that I can use to help me > keep track of drupal documentation? I know there are social > bookmarking sites, are there any that any other documentation team > members have found have particularly useful? Delicious is great: http://delicious.com/ http://delicious.com/nborda/drupal+handbook HTH -- Nicolas http://nic.ipwa.net/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081203/17567c5d/attachment-0001.htm From esmerel at logrus.com Wed Dec 3 23:25:22 2008 From: esmerel at logrus.com (Lynette) Date: Wed, 03 Dec 2008 15:25:22 -0800 Subject: [documentation] Bookmarking function? In-Reply-To: <2019048D-80C8-49D9-876E-C14CCBEB777F@ipwa.net> References: <351891.57235.qm@web1109.biz.mail.sk1.yahoo.com> <2019048D-80C8-49D9-876E-C14CCBEB777F@ipwa.net> Message-ID: <49371562.5030807@logrus.com> I pretty much use delicious for all my bookmarking - but it just stores the URL, page title, and tags (all of which are modifiable before saving). I <3 it though, it's clean, simple, easy to read from a mobile phone browser, AND has a drupal integration module! http://drupal.org/project/delicious Nicolas Borda wrote: > > On 3 Dec 2008, at 22:02, Erin Rasmussen wrote: > >> Is there an online bookmarking system that I can use to help me keep >> track of drupal documentation? I know there are social bookmarking >> sites, are there any that any other documentation team members have >> found have particularly useful? > > Delicious is great: http://delicious.com/ > > http://delicious.com/nborda/drupal+handbook > > HTH > > -- > > Nicolas > > http://nic.ipwa.net/ > > > > > ------------------------------------------------------------------------ > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ From drupal at rocktreesky.com Sat Dec 6 12:59:48 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Sat, 6 Dec 2008 07:59:48 -0500 Subject: [documentation] New Help System Docs in Drupal 7 Message-ID: Hey folks, so there has been a ton of work done on getting a new help system into Drupal core. They are now at the point of writing documentation to add to the system. I have cross-posted two posts from their group (http://groups.drupal.org/help-system) into the Documentation team group: Interested in contributing to core documentation? http://groups.drupal.org/node/17287 Style Guidelines for Help System http://groups.drupal.org/node/17302 We *really* need to coordinate with this effort. Check it out, speak up and dig in. Thanks - 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 drupal at rocktreesky.com Sat Dec 6 22:52:08 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Sat, 6 Dec 2008 17:52:08 -0500 Subject: [documentation] return of most popular handbook pages list Message-ID: <33B72181-01D4-4025-8866-70BA2AB4DAD1@rocktreesky.com> For those that were wondering, the old Most popular handbook pages list (handbook/most-popular-pages) stopped working earlier this year because d.o stopped using the stats module from which we were programmatically pulling the list. After a bit of back and forth, the list is back in a different form. I am manually compiling a list of the top 25 for each month from the server log AWStats. I have added the link back to the Documentation links block as well. Enjoy. - 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 dmitrig01 at gmail.com Sun Dec 7 17:08:21 2008 From: dmitrig01 at gmail.com (Dmitri Gaskin) Date: Sun, 7 Dec 2008 09:08:21 -0800 Subject: [documentation] Contributions needed to core documentation Message-ID: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> Drupal 7 will (hopefully) see the introduction of a new and completely overhauled help system (read: starting from scratch). However, this means that all documentation must be re-written. This is not a job for one person! We need everyone to pitch in and help (no pun intended). If everyone can write two (2) pages, then we'll be very well off. The kind people at the Help System group on groups.drupal.org (http://groups.drupal.org/help-system ) have assembled a workflow for you to take part in. Here's how to write a help page for a module: 1. Log in here. If you don't already have an account, you can log in with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your drupal.org password as your password. 2. Navigate your browser to http://groups.drupal.org/node/add/wikipage?gids []=12401 to start your new wiki page. 3. Choose "Drupal Documentation Task" for the "Group categories" vocabulary 4. Choose the name of the module for which you are writing documentation for the "Help topic module" vocabulary 5. Fill in the title and the body to those that you wish to appear on your help page. 6. Be sure to adhere to the guidelines ("http://groups.drupal.org/node/17302 "). 7. Hit submit! If everyone can do two (2) of these, we'll have all the help pages in core done in a matter of days. And guess who it starts with? You! If you would like to edit an existing page, simply go to the Help System group (http://groups.drupal.org/help-system) find the page along the left, click on it, and click the edit tab. Things to note: 1. The topic titles of each module, on the left side of group page, are not listed in any order (although the modules are). The final order can be decided later. 2. We are not using the drupal.org handbooks for specific styles/ patterns that we need to follow for the help module's requirements. Check comments at http://groups.drupal.org/node/17287 for further information. -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.drupal.org/pipermail/documentation/attachments/20081207/f4d6beec/attachment.htm From victorkane at gmail.com Sun Dec 7 17:10:23 2008 From: victorkane at gmail.com (Victor Kane) Date: Sun, 7 Dec 2008 15:10:23 -0200 Subject: [documentation] Contributions needed to core documentation In-Reply-To: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> References: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> Message-ID: No! Documentation should be crowd-sourced, on the heels of the excellent opening up of the editing of the document handbooks. It shouldn't require "extra work", but rather, a climate favorable to crowd participation should be created. Victor Kane http://awebfactory.com.ar On Sun, Dec 7, 2008 at 3:08 PM, Dmitri Gaskin wrote: > Drupal 7 will (hopefully) see the introduction of a new and completely > overhauled help system (read: starting from scratch). > However, this means that all documentation must be re-written. > This is not a job for one person! We need everyone to pitch in and help (no > pun intended). If everyone can write two (2) pages, then we'll be > very well off. > The kind people at the Help System group on groups.drupal.org > (http://groups.drupal.org/help-system) have assembled a workflow for you to > take part in. Here's how to write a help page for a module: > 1. Log in here. If you > don't already have an account, you can log in > with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your drupal.org > password as your password. > 2. Navigate your browser > to http://groups.drupal.org/node/add/wikipage?gids[]=12401 to start your new > wiki page. > 3. Choose "Drupal Documentation Task" for the "Group categories" vocabulary > 4. Choose the name of the module for which you are writing documentation for > the "Help topic module" vocabulary > 5. Fill in the title and the body to those that you wish to appear on your > help page. > 6. Be sure to adhere to the guidelines > ("http://groups.drupal.org/node/17302"). > 7. Hit submit! > If everyone can do two (2) of these, we'll have all the help pages in core > done in a matter of days. And guess who it starts with? You! > If you would like to edit an existing page, simply go to the Help System > group (http://groups.drupal.org/help-system) find the page along the left, > click on it, and click the edit tab. > Things to note: > 1. The topic titles of each module, on the left side of group page, are not > listed in any order (although the modules are). The final order can be > decided later. > 2. We are not using the drupal.org handbooks for specific styles/patterns > that we need to follow for the help module's requirements. Check comments > at http://groups.drupal.org/node/17287 for further information. > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ > From dmitrig01 at gmail.com Sun Dec 7 17:19:20 2008 From: dmitrig01 at gmail.com (Dmitri Gaskin) Date: Sun, 7 Dec 2008 09:19:20 -0800 Subject: [documentation] Contributions needed to core documentation In-Reply-To: References: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> Message-ID: <3B37D4E5-5747-4B1B-A979-464AF8DA8539@gmail.com> Describe please. Sorry for sending the email multiple times. Dmitri On Dec 7, 2008, at 9:10 AM, Victor Kane wrote: > No! > > Documentation should be crowd-sourced, on the heels of the excellent > opening up of the editing of the document handbooks. > > It shouldn't require "extra work", but rather, a climate favorable to > crowd participation should be created. > > Victor Kane > http://awebfactory.com.ar > > On Sun, Dec 7, 2008 at 3:08 PM, Dmitri Gaskin > wrote: >> Drupal 7 will (hopefully) see the introduction of a new and >> completely >> overhauled help system (read: starting from scratch). >> However, this means that all documentation must be re-written. >> This is not a job for one person! We need everyone to pitch in and >> help (no >> pun intended). If everyone can write two (2) pages, then we'll be >> very well off. >> The kind people at the Help System group on groups.drupal.org >> (http://groups.drupal.org/help-system) have assembled a workflow >> for you to >> take part in. Here's how to write a help page for a module: >> 1. Log in here. >> If you >> don't already have an account, you can log in >> with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your >> drupal.org >> password as your password. >> 2. Navigate your browser >> to http://groups.drupal.org/node/add/wikipage?gids[]=12401 to start >> your new >> wiki page. >> 3. Choose "Drupal Documentation Task" for the "Group categories" >> vocabulary >> 4. Choose the name of the module for which you are writing >> documentation for >> the "Help topic module" vocabulary >> 5. Fill in the title and the body to those that you wish to appear >> on your >> help page. >> 6. Be sure to adhere to the guidelines >> ("http://groups.drupal.org/node/17302"). >> 7. Hit submit! >> If everyone can do two (2) of these, we'll have all the help pages >> in core >> done in a matter of days. And guess who it starts with? You! >> If you would like to edit an existing page, simply go to the Help >> System >> group (http://groups.drupal.org/help-system) find the page along >> the left, >> click on it, and click the edit tab. >> Things to note: >> 1. The topic titles of each module, on the left side of group page, >> are not >> listed in any order (although the modules are). The final order can >> be >> decided later. >> 2. We are not using the drupal.org handbooks for specific styles/ >> patterns >> that we need to follow for the help module's requirements. Check >> comments >> at http://groups.drupal.org/node/17287 for further information. >> -- >> 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 victorkane at gmail.com Sun Dec 7 17:21:56 2008 From: victorkane at gmail.com (Victor Kane) Date: Sun, 7 Dec 2008 15:21:56 -0200 Subject: [documentation] Contributions needed to core documentation In-Reply-To: References: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> Message-ID: Module maintainers should start writing docs in the new context, anyone who just figured out something, document team members can write overviews like the theming handbook... That way, it can be written gradually, not in one heroic go. On Sun, Dec 7, 2008 at 3:10 PM, Victor Kane wrote: > No! > > Documentation should be crowd-sourced, on the heels of the excellent > opening up of the editing of the document handbooks. > > It shouldn't require "extra work", but rather, a climate favorable to > crowd participation should be created. > > Victor Kane > http://awebfactory.com.ar > > On Sun, Dec 7, 2008 at 3:08 PM, Dmitri Gaskin wrote: >> Drupal 7 will (hopefully) see the introduction of a new and completely >> overhauled help system (read: starting from scratch). >> However, this means that all documentation must be re-written. >> This is not a job for one person! We need everyone to pitch in and help (no >> pun intended). If everyone can write two (2) pages, then we'll be >> very well off. >> The kind people at the Help System group on groups.drupal.org >> (http://groups.drupal.org/help-system) have assembled a workflow for you to >> take part in. Here's how to write a help page for a module: >> 1. Log in here. If you >> don't already have an account, you can log in >> with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your drupal.org >> password as your password. >> 2. Navigate your browser >> to http://groups.drupal.org/node/add/wikipage?gids[]=12401 to start your new >> wiki page. >> 3. Choose "Drupal Documentation Task" for the "Group categories" vocabulary >> 4. Choose the name of the module for which you are writing documentation for >> the "Help topic module" vocabulary >> 5. Fill in the title and the body to those that you wish to appear on your >> help page. >> 6. Be sure to adhere to the guidelines >> ("http://groups.drupal.org/node/17302"). >> 7. Hit submit! >> If everyone can do two (2) of these, we'll have all the help pages in core >> done in a matter of days. And guess who it starts with? You! >> If you would like to edit an existing page, simply go to the Help System >> group (http://groups.drupal.org/help-system) find the page along the left, >> click on it, and click the edit tab. >> Things to note: >> 1. The topic titles of each module, on the left side of group page, are not >> listed in any order (although the modules are). The final order can be >> decided later. >> 2. We are not using the drupal.org handbooks for specific styles/patterns >> that we need to follow for the help module's requirements. Check comments >> at http://groups.drupal.org/node/17287 for further information. >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ >> > From dmitrig01 at gmail.com Sun Dec 7 18:41:58 2008 From: dmitrig01 at gmail.com (Dmitri Gaskin) Date: Sun, 7 Dec 2008 10:41:58 -0800 Subject: [documentation] Contributions needed to core documentation In-Reply-To: References: <8E690C27-B439-4E34-8944-79EF9FB358FC@gmail.com> Message-ID: That would be optimal, but we need new documentation for Drupal 7. What people put in to there will not be filling up the handbooks, it will be transfered into the new help system included in drupal core. It will be come the help pages. We need *some* help to be included in core, because there is no guarentee that it will come in later. So if we can at least get a large start, not all of it needs to be finished, but a lot of it. Dmitri On Dec 7, 2008, at 9:21 AM, Victor Kane wrote: > Module maintainers should start writing docs in the new context, > anyone who just figured out something, document team members can write > overviews like the theming handbook... > > That way, it can be written gradually, not in one heroic go. > > > > On Sun, Dec 7, 2008 at 3:10 PM, Victor Kane > wrote: >> No! >> >> Documentation should be crowd-sourced, on the heels of the excellent >> opening up of the editing of the document handbooks. >> >> It shouldn't require "extra work", but rather, a climate favorable to >> crowd participation should be created. >> >> Victor Kane >> http://awebfactory.com.ar >> >> On Sun, Dec 7, 2008 at 3:08 PM, Dmitri Gaskin >> wrote: >>> Drupal 7 will (hopefully) see the introduction of a new and >>> completely >>> overhauled help system (read: starting from scratch). >>> However, this means that all documentation must be re-written. >>> This is not a job for one person! We need everyone to pitch in and >>> help (no >>> pun intended). If everyone can write two (2) pages, then we'll be >>> very well off. >>> The kind people at the Help System group on groups.drupal.org >>> (http://groups.drupal.org/help-system) have assembled a workflow >>> for you to >>> take part in. Here's how to write a help page for a module: >>> 1. Log in here. >>> If you >>> don't already have an account, you can log in >>> with YOUR_DRUPAL.ORG_USERNAME at drupal.org as your usename and your >>> drupal.org >>> password as your password. >>> 2. Navigate your browser >>> to http://groups.drupal.org/node/add/wikipage?gids[]=12401 to >>> start your new >>> wiki page. >>> 3. Choose "Drupal Documentation Task" for the "Group categories" >>> vocabulary >>> 4. Choose the name of the module for which you are writing >>> documentation for >>> the "Help topic module" vocabulary >>> 5. Fill in the title and the body to those that you wish to appear >>> on your >>> help page. >>> 6. Be sure to adhere to the guidelines >>> ("http://groups.drupal.org/node/17302"). >>> 7. Hit submit! >>> If everyone can do two (2) of these, we'll have all the help pages >>> in core >>> done in a matter of days. And guess who it starts with? You! >>> If you would like to edit an existing page, simply go to the Help >>> System >>> group (http://groups.drupal.org/help-system) find the page along >>> the left, >>> click on it, and click the edit tab. >>> Things to note: >>> 1. The topic titles of each module, on the left side of group >>> page, are not >>> listed in any order (although the modules are). The final order >>> can be >>> decided later. >>> 2. We are not using the drupal.org handbooks for specific styles/ >>> patterns >>> that we need to follow for the help module's requirements. Check >>> comments >>> at http://groups.drupal.org/node/17287 for further information. >>> -- >>> 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 Dec 16 13:38:23 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Tue, 16 Dec 2008 08:38:23 -0500 Subject: [documentation] Next IRC meeting? Message-ID: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> I'd like for us to have an IRC meeting to see where various projects are and talk about current issues and the redesign. The holidays are upon us so I wanted to check if folks were up for a meeting at the end of this week before they start in earnest. if so, I'll start a Doodle for this week. If not we can wait until the first week in January. Please respond and let me know! - Addi (add1sun) www.lullabot.com Our Drupal DVD: - Understanding Drupal: http://store.lullabot.com/products/understanding-drupal Our Drupal Books: - Pro Drupal Development: http://www.amazon.com/o/ASIN/1430209895/lullabot-20 - Using Drupal: http://www.amazon.com/o/ASIN/0596515804/lullabot-20 From shai at content2zero.com Tue Dec 16 14:41:35 2008 From: shai at content2zero.com (Shai Gluskin) Date: Tue, 16 Dec 2008 09:41:35 -0500 Subject: [documentation] Next IRC meeting? In-Reply-To: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> References: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> Message-ID: <9f68efb70812160641p25b5b647me0cc883b1ce98b77@mail.gmail.com> Addi and all, I could go either way... feeling a bit swamped but I also need a kick in....... to get back on task with the docs stuff. shai On Tue, Dec 16, 2008 at 8:38 AM, Addison Berry wrote: > I'd like for us to have an IRC meeting to see where various projects > are and talk about current issues and the redesign. The holidays are > upon us so I wanted to check if folks were up for a meeting at the end > of this week before they start in earnest. if so, I'll start a Doodle > for this week. If not we can wait until the first week in January. > Please respond and let me know! > > > - Addi (add1sun) > > www.lullabot.com > Our Drupal DVD: > - Understanding Drupal: > http://store.lullabot.com/products/understanding-drupal > Our Drupal Books: > - Pro Drupal Development: > http://www.amazon.com/o/ASIN/1430209895/lullabot-20 > - Using Drupal: http://www.amazon.com/o/ASIN/0596515804/lullabot-20 > > -- > 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/20081216/50e92757/attachment.htm From joshua at brauerranch.com Tue Dec 16 14:41:51 2008 From: joshua at brauerranch.com (Joshua Brauer) Date: Tue, 16 Dec 2008 07:41:51 -0700 Subject: [documentation] Next IRC meeting? In-Reply-To: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> References: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> Message-ID: End of the week could work... On Dec 16, 2008, at 6:38 AM, Addison Berry wrote: > I'd like for us to have an IRC meeting to see where various projects > are and talk about current issues and the redesign. The holidays are > upon us so I wanted to check if folks were up for a meeting at the end > of this week before they start in earnest. if so, I'll start a Doodle > for this week. If not we can wait until the first week in January. > Please respond and let me know! > > > - Addi (add1sun) > > www.lullabot.com > Our Drupal DVD: > - Understanding Drupal: http://store.lullabot.com/products/understanding-drupal > Our Drupal Books: > - Pro Drupal Development: http://www.amazon.com/o/ASIN/1430209895/lullabot-20 > - Using Drupal: http://www.amazon.com/o/ASIN/0596515804/lullabot-20 > > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ -------------- next part -------------- A non-text attachment was scrubbed... Name: smime.p7s Type: application/pkcs7-signature Size: 1592 bytes Desc: not available Url : http://lists.drupal.org/pipermail/documentation/attachments/20081216/82b1d25c/attachment.bin From drupal at rocktreesky.com Tue Dec 16 16:33:46 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Tue, 16 Dec 2008 11:33:46 -0500 Subject: [documentation] Schedule Next IRC meeting this week In-Reply-To: References: <6C89F2E3-FF4D-45A8-A3C3-BFB89763A56D@rocktreesky.com> Message-ID: Ok, I've gotten feedback from here and IRC to go ahead and schedule. Here is the Doodle: http://doodle.com/34ap6e6y24t7isv6 We will meet for one hour in the #drupal-docs IRC channel on the FreeNode network. Please *vote on Doodle* by Wednesday (tomorrow) midnight GMT (7pm EST, 4pm PST). Agenda: Announcements Status on Theme guide reorg More Getting Started org discussion Talk about redesign status Discuss the new help system in core issues - Addi (add1sun) On Dec 16, 2008, at 9:41 AM, Joshua Brauer wrote: > End of the week could work... > > On Dec 16, 2008, at 6:38 AM, Addison Berry wrote: > >> I'd like for us to have an IRC meeting to see where various projects >> are and talk about current issues and the redesign. The holidays are >> upon us so I wanted to check if folks were up for a meeting at the >> end >> of this week before they start in earnest. if so, I'll start a Doodle >> for this week. If not we can wait until the first week in January. >> Please respond and let me know! >> >> >> - Addi (add1sun) >> >> www.lullabot.com >> Our Drupal DVD: >> - Understanding Drupal: http://store.lullabot.com/products/understanding-drupal >> Our Drupal Books: >> - Pro Drupal Development: http://www.amazon.com/o/ASIN/1430209895/lullabot-20 >> - Using Drupal: http://www.amazon.com/o/ASIN/0596515804/lullabot-20 >> >> -- >> 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/20081216/0e7a8932/attachment-0001.htm From larry at garfieldtech.com Wed Dec 17 08:21:19 2008 From: larry at garfieldtech.com (Larry Garfield) Date: Wed, 17 Dec 2008 02:21:19 -0600 Subject: [documentation] DBTNG docs need review Message-ID: <200812170221.19201.larry@garfieldtech.com> Hello, documentation type people. :-) Some time ago I wrote up documentation on the new DBTNG system. It was good, save for conditional handling which was missing for a while because it was much harder to explain. That is now written. And there was much rejoicing. I would therefore like to get feedback from the Docs folks on the documentation, particularly on the conditionals as that's the hardest part to grok. http://drupal.org/dbtng-documentation Comments on the pages, replies to this email, or direct edits for small things are all cool by me. :-) I know driver documentation is still missing. That's because that API is still subject to change, so it's not worth documenting until we're done breaking it. Thanks all! -- Larry Garfield larry at garfieldtech.com From robloach at gmail.com Wed Dec 17 17:02:29 2008 From: robloach at gmail.com (Rob Loach) Date: Wed, 17 Dec 2008 12:02:29 -0500 Subject: [documentation] DBTNG docs need review In-Reply-To: <200812170221.19201.larry@garfieldtech.com> References: <200812170221.19201.larry@garfieldtech.com> Message-ID: <494930A5.3020403@gmail.com> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi Larry, Nicely done on the documentation. Everything is easy to read, and well organized. Great job! One thing to note is that hook.api.php files made it into core (http://drupal.org/node/314870), so are there any places with the new database layer that would benefit from having any extra database.api.php documentation files around? Thanks a lot, - -- Rob Loach http://www.robloach.net Larry Garfield wrote: > Hello, documentation type people. :-) > > Some time ago I wrote up documentation on the new DBTNG system. It was good, > save for conditional handling which was missing for a while because it was > much harder to explain. That is now written. And there was much rejoicing. > > I would therefore like to get feedback from the Docs folks on the > documentation, particularly on the conditionals as that's the hardest part to > grok. > > http://drupal.org/dbtng-documentation > > Comments on the pages, replies to this email, or direct edits for small things > are all cool by me. :-) I know driver documentation is still missing. That's > because that API is still subject to change, so it's not worth documenting > until we're done breaking it. > > Thanks all! > -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.6 (GNU/Linux) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFJSTCkYn9qH3fN54QRAp8CAKCnHpjiO+bGB+m0sc7GFkMXSZc5TACfRdWj lex4xlzqf6wkHYULSGjZLEU= =xK2h -----END PGP SIGNATURE----- From drupal at rocktreesky.com Wed Dec 17 21:49:23 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Wed, 17 Dec 2008 16:49:23 -0500 Subject: [documentation] December IRC meeting References: <20081217213034.E3DFF16B4E7@www1.drupal.org> Message-ID: <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> > add1sun has posted a Event at http://groups.drupal.org/node/17610 > > December IRC meeting > --------------- > The Doodle has spoken. Next meeting is Thursday, December 18 at noon > EST (17:00 GMT, 9 a.m. PST). > We will meet for one hour in the #drupal-docs IRC channel on the > FreeNode network and discuss: > Announcements > Status on Theme guide reorg > More Getting Started org discussion > Talk about redesign status > Discuss the new help system in core issues - Addi From larry at garfieldtech.com Thu Dec 18 04:28:51 2008 From: larry at garfieldtech.com (Larry Garfield) Date: Wed, 17 Dec 2008 22:28:51 -0600 Subject: [documentation] DBTNG docs need review In-Reply-To: <494930A5.3020403@gmail.com> References: <200812170221.19201.larry@garfieldtech.com> <494930A5.3020403@gmail.com> Message-ID: <200812172228.51890.larry@garfieldtech.com> On Wednesday 17 December 2008 11:02:29 am you wrote: > Hi Larry, > > Nicely done on the documentation. Everything is easy to read, and well > organized. Great job! > > One thing to note is that hook.api.php files made it into core > (http://drupal.org/node/314870), so are there any places with the new > database layer that would benefit from having any extra database.api.php > documentation files around? > > Thanks a lot, Hey neat, that made it in. I think DBTNG introduces only one hook, hook_query_alter, so I've opened an issue for that: http://drupal.org/node/348519 I'm not sure that in-code is the best place to document the rest of DBTNG, beyond the docblocks already in database.inc. The handbooks are probably better as it's less API samples and more prose explanations. That said, I'm fine if someone wants to copy portions of the handbooks into a docblock. (Technically the licenses are incompatible, but as the original author of 98% of the DBTNG documentation I hereby dual-license it as needed yadda yadda.) -- Larry Garfield larry at garfieldtech.com From catch56 at googlemail.com Thu Dec 18 09:54:21 2008 From: catch56 at googlemail.com (Nathaniel Catchpole) Date: Thu, 18 Dec 2008 09:54:21 +0000 Subject: [documentation] DBTNG docs need review In-Reply-To: <200812172228.51890.larry@garfieldtech.com> References: <200812170221.19201.larry@garfieldtech.com> <494930A5.3020403@gmail.com> <200812172228.51890.larry@garfieldtech.com> Message-ID: Just saw the docs here have been updated - http://api.drupal.org/api/group/database/7 - this could do with a link to the handbook section too though probably. Nat On Thu, Dec 18, 2008 at 4:28 AM, Larry Garfield wrote: > On Wednesday 17 December 2008 11:02:29 am you wrote: > > Hi Larry, > > > > Nicely done on the documentation. Everything is easy to read, and well > > organized. Great job! > > > > One thing to note is that hook.api.php files made it into core > > (http://drupal.org/node/314870), so are there any places with the new > > database layer that would benefit from having any extra database.api.php > > documentation files around? > > > > Thanks a lot, > > Hey neat, that made it in. > > I think DBTNG introduces only one hook, hook_query_alter, so I've opened an > issue for that: > > http://drupal.org/node/348519 > > I'm not sure that in-code is the best place to document the rest of DBTNG, > beyond the docblocks already in database.inc. The handbooks are probably > better as it's less API samples and more prose explanations. That said, > I'm > fine if someone wants to copy portions of the handbooks into a docblock. > (Technically the licenses are incompatible, but as the original author of > 98% > of the DBTNG documentation I hereby dual-license it as needed yadda yadda.) > > -- > Larry Garfield > larry at garfieldtech.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/20081218/39fc7a0e/attachment.htm From larry at garfieldtech.com Thu Dec 18 16:18:38 2008 From: larry at garfieldtech.com (Larry Garfield) Date: Thu, 18 Dec 2008 10:18:38 -0600 Subject: [documentation] DBTNG docs need review In-Reply-To: References: Message-ID: <76270afc5f071d5c63e5e009650fd7cb@localhost> Changed the link on the first page of the docs to point to the database group directly. API.module still needs to be taught how to handle classes, though. --Larry Garfield On Thu, 18 Dec 2008 09:54:21 +0000, "Nathaniel Catchpole" wrote: > Just saw the docs here have been updated - > http://api.drupal.org/api/group/database/7 - this could do with a link to > the handbook section too though probably. > > Nat > > On Thu, Dec 18, 2008 at 4:28 AM, Larry Garfield > wrote: > >> On Wednesday 17 December 2008 11:02:29 am you wrote: >> > Hi Larry, >> > >> > Nicely done on the documentation. Everything is easy to read, and well >> > organized. Great job! >> > >> > One thing to note is that hook.api.php files made it into core >> > (http://drupal.org/node/314870), so are there any places with the new >> > database layer that would benefit from having any extra > database.api.php >> > documentation files around? >> > >> > Thanks a lot, >> >> Hey neat, that made it in. >> >> I think DBTNG introduces only one hook, hook_query_alter, so I've opened > an >> issue for that: >> >> http://drupal.org/node/348519 >> >> I'm not sure that in-code is the best place to document the rest of > DBTNG, >> beyond the docblocks already in database.inc. The handbooks are > probably >> better as it's less API samples and more prose explanations. That said, >> I'm >> fine if someone wants to copy portions of the handbooks into a docblock. >> (Technically the licenses are incompatible, but as the original author > of >> 98% >> of the DBTNG documentation I hereby dual-license it as needed yadda > yadda.) >> >> -- >> Larry Garfield >> larry at garfieldtech.com >> -- >> Pending work: http://drupal.org/project/issues/documentation/ >> List archives: http://lists.drupal.org/pipermail/documentation/ >> > > From drupal at rocktreesky.com Thu Dec 18 16:59:08 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Thu, 18 Dec 2008 11:59:08 -0500 Subject: [documentation] REMINDER: December IRC meeting starting now-ish References: <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> Message-ID: <695A20E2-92E2-405C-A881-622E91FD0AD6@rocktreesky.com> Just a reminder, since this meeting came up so quickly, that we are starting in a few minutes. Begin forwarded message: > From: Addison Berry > Date: December 17, 2008 4:49:23 PM EST > To: documentation at drupal.org > Subject: [documentation] December IRC meeting > Reply-To: A list for documentation writers > >> add1sun has posted a Event at http://groups.drupal.org/node/17610 >> >> December IRC meeting >> --------------- >> The Doodle has spoken. Next meeting is Thursday, December 18 at noon >> EST (17:00 GMT, 9 a.m. PST). > >> We will meet for one hour in the #drupal-docs IRC channel on the >> FreeNode network and discuss: >> Announcements >> Status on Theme guide reorg >> More Getting Started org discussion >> Talk about redesign status >> Discuss the new help system in core issues > > - 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: http://lists.drupal.org/pipermail/documentation/attachments/20081218/cc7c85a4/attachment-0001.htm From pinglaura at gmail.com Thu Dec 18 18:10:33 2008 From: pinglaura at gmail.com (Laura Scott) Date: Thu, 18 Dec 2008 11:10:33 -0700 Subject: [documentation] December IRC meeting In-Reply-To: <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> References: <20081217213034.E3DFF16B4E7@www1.drupal.org> <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> Message-ID: <4E700844-A662-4678-8093-0399BD19C26F@gmail.com> Sorry I couldn't make it. My Colloquy is deaf and blind for some reason. But I do intend to get back onto doc tasks in the new year. Laura On Wed Dec 17, 2008, at 2:49 pm, Addison Berry wrote: >> add1sun has posted a Event at http://groups.drupal.org/node/17610 >> >> December IRC meeting >> --------------- >> The Doodle has spoken. Next meeting is Thursday, December 18 at noon >> EST (17:00 GMT, 9 a.m. PST). > >> We will meet for one hour in the #drupal-docs IRC channel on the >> FreeNode network and discuss: >> Announcements >> Status on Theme guide reorg >> More Getting Started org discussion >> Talk about redesign status >> Discuss the new help system in core issues > > - Addi > -- > Pending work: http://drupal.org/project/issues/documentation/ > List archives: http://lists.drupal.org/pipermail/documentation/ From andrewberry at sentex.net Thu Dec 18 18:21:29 2008 From: andrewberry at sentex.net (Andrew Berry) Date: Thu, 18 Dec 2008 13:21:29 -0500 Subject: [documentation] December IRC meeting In-Reply-To: <4E700844-A662-4678-8093-0399BD19C26F@gmail.com> References: <20081217213034.E3DFF16B4E7@www1.drupal.org> <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> <4E700844-A662-4678-8093-0399BD19C26F@gmail.com> Message-ID: <3CEAFA3A-C338-4704-A8C4-B305AAE74910@sentex.net> On 18-Dec-08, at 1:10 PM, Laura Scott wrote: > Sorry I couldn't make it. My Colloquy is deaf and blind for some > reason. But I do intend to get back onto doc tasks in the new year. It's a bug in Webkit apparently - try "/reload style" in the channel that's not showing anything. I have to do it about once a week. --Andrew -------------- next part -------------- A non-text attachment was scrubbed... Name: smime.p7s Type: application/pkcs7-signature Size: 2672 bytes Desc: not available Url : http://lists.drupal.org/pipermail/documentation/attachments/20081218/08ade2d3/attachment.bin From drumm at delocalizedham.com Thu Dec 18 21:13:18 2008 From: drumm at delocalizedham.com (Neil Drumm) Date: Thu, 18 Dec 2008 13:13:18 -0800 Subject: [documentation] DBTNG docs need review In-Reply-To: <76270afc5f071d5c63e5e009650fd7cb@localhost> References: <76270afc5f071d5c63e5e009650fd7cb@localhost> Message-ID: Yes, that is high on the list. We need to chunk the code into functions/constants/etc with PHP's tokenizer instead of regular expressions hard-coded to our coding conventions. http://drupal.org/node/300031 -Neil On Thu, Dec 18, 2008 at 8:18 AM, Larry Garfield wrote: > > Changed the link on the first page of the docs to point to the database group directly. API.module still needs to be taught how to handle classes, though. > > --Larry Garfield > > On Thu, 18 Dec 2008 09:54:21 +0000, "Nathaniel Catchpole" wrote: >> Just saw the docs here have been updated - >> http://api.drupal.org/api/group/database/7 - this could do with a link to >> the handbook section too though probably. >> >> Nat >> >> On Thu, Dec 18, 2008 at 4:28 AM, Larry Garfield >> wrote: >> >>> On Wednesday 17 December 2008 11:02:29 am you wrote: >>> > Hi Larry, >>> > >>> > Nicely done on the documentation. Everything is easy to read, and well >>> > organized. Great job! >>> > >>> > One thing to note is that hook.api.php files made it into core >>> > (http://drupal.org/node/314870), so are there any places with the new >>> > database layer that would benefit from having any extra >> database.api.php >>> > documentation files around? >>> > >>> > Thanks a lot, >>> >>> Hey neat, that made it in. >>> >>> I think DBTNG introduces only one hook, hook_query_alter, so I've opened >> an >>> issue for that: >>> >>> http://drupal.org/node/348519 >>> >>> I'm not sure that in-code is the best place to document the rest of >> DBTNG, >>> beyond the docblocks already in database.inc. The handbooks are >> probably >>> better as it's less API samples and more prose explanations. That said, >>> I'm >>> fine if someone wants to copy portions of the handbooks into a docblock. >>> (Technically the licenses are incompatible, but as the original author >> of >>> 98% >>> of the DBTNG documentation I hereby dual-license it as needed yadda >> yadda.) >>> >>> -- >>> Larry Garfield >>> larry at garfieldtech.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/ > -- Neil Drumm http://delocalizedham.com From pinglaura at gmail.com Fri Dec 19 00:44:12 2008 From: pinglaura at gmail.com (Laura Scott) Date: Thu, 18 Dec 2008 17:44:12 -0700 Subject: [documentation] December IRC meeting In-Reply-To: <3CEAFA3A-C338-4704-A8C4-B305AAE74910@sentex.net> References: <20081217213034.E3DFF16B4E7@www1.drupal.org> <6AA94FCD-C3D5-49FA-B395-687D9E694BD1@rocktreesky.com> <4E700844-A662-4678-8093-0399BD19C26F@gmail.com> <3CEAFA3A-C338-4704-A8C4-B305AAE74910@sentex.net> Message-ID: <425F59F8-6E2E-4C93-AC19-E258B0DB2A5C@gmail.com> On Dec 18, 2008, at 11:21 am, Andrew Berry wrote: > On 18-Dec-08, at 1:10 PM, Laura Scott wrote: > >> Sorry I couldn't make it. My Colloquy is deaf and blind for some >> reason. But I do intend to get back onto doc tasks in the new year. > > It's a bug in Webkit apparently - try "/reload style" in the channel > that's not showing anything. I have to do it about once a week. No joy. Total Fail on Colloquy. Thanks for the tip, though. I would manually reset the style via GUI and that would work before. No more. Laura From drupal at rocktreesky.com Fri Dec 19 17:35:08 2008 From: drupal at rocktreesky.com (Addison Berry) Date: Fri, 19 Dec 2008 12:35:08 -0500 Subject: [documentation] Dec. 18 IRC meeting Summary and Log References: <20081219173022.4C22216B54B@www1.drupal.org> Message-ID: <7FF7DF31-6FEB-4B98-8998-0C5893C8618F@rocktreesky.com> > Dec. 18 IRC meeting Summary and Log > --------------- > This is a summary of the IRC meeting held December 18. The IRC log > is available here: http://pastebin.com/f57aa5c9e > **Announcements > - The KDI sprint funding is pending so I'm starting to plan doc > sprints for next year at camps around the world. If folks are aware > of camps being planned, please keep me in the loop for a potential > sprints. > > - Re: the OG vs mailing list conversation, Moshe is open to tieing > the two together but none of the current solutions are solid. I'll > be getting more info on what's needed and who might help in the next > few weeks. > > **Status on Theme guide reorg http://groups.drupal.org/node/16594 > Overall the shake has been good and major pieces ahve been moved. We > had an extended discussion about using Diigo and agreed that it is a > useful tool with a few questions and caveats. We need to write up a > doc about how we want to use Diigo; best practices, conventions, etc. > > **More Getting Started org discussion > Most of the meeting was spent discussing organizational issues for > the getting Started book (some initial discussion here: http://drupal.org/node/337079) > . For now, we'll leave the D5 GS guide alone and start a rework with > the D6 guide. We already moved the Install section up to a top level > in the book. We'll do the same for Build and Admin sections, i.e. > move that info out of http://drupal.org/getting-started/6, up a > level and then removing the Drupal 6 landing page. Read the > transcript, starting on line 90, to see the whole discussion. > > **Talk about redesign status > MBD contract is over and they have delivered the style guide. > Implementation will need to be done by the community and the exact > next steps aren't dtermined yet. The Infra group (http://groups.drupal.org/drupalorg-redesign-infrastructure-team > ) is beginning work to split sites out and work on the upgrade to D6. > > **Discuss the new help system in core issues > We ran out of time to talk about this one, so we'll move this to the > top of the next meeting agenda. addi