The problem with Drupal documentation
Blog Roll
First things first: I've you've ever looked at Acquia's documentation, read this post and take the survey. You're welcome, jam. ;)Now, a confession: I went to the Drupal.org documentation sprint at DrupalCon. And I tried to be useful, really I did. But I found myself frustrated, unable to really engage in it, and left mid-day feeling horribly guilty. Why? I think there were two causes:
- The task is so immense. Drupal.org's documentation has grown like topsy, and now useful information is dispersed throughout several unconnected areas. The search function is really all that brings them together.
- Quality varies wildly. The biggest sin is, as usual, too much writing. As I often say, writing is easy; editing is hard. Brevity is the soul of wit. Your mama wears combat boots. And so forth.
I wrestled with the task facing doc team lead Addison Berry: What would I do in her place? My answer surprised me: I'd burn it all down and start again. I'm reminded of the real-estate markets of Detroit, Cleveland, and Buffalo. In those cities there are blocks full of houses that are worth less than nothing: They're too dilapidated to restore, and the cost to demolish them (about $8,000) is greater than the land's value. And ashes are cheaper to truck away than lumber, even if the burning dumps toxins in the soil. What "city blocks" on Drupal.org are like that? Such arson is unlikely to happen on Drupal.org. For one thing, it's discouraging to sweat out a long document, and then discover that it's disappeared. How many people would stop contributing documentation as a result? How would the community's soil be poisoned? I'd still recommend cutting mercilessly. I believe at least 75% of the words on Drupal.org could and should be lost. But who would do the cutting? It's tough work, and without glory. Converting Drupal.org's documentation into a wiki(-like) format might help "crowdsource" the task. Or maybe not. Nobody likes to cut. Editing is hard. Which leads us back to Acquia. Acquia is a "third-party documentation provider", like the Lullabots and GotDrupal and DrupalTherapy and many others... and me. It's tempting to say that we thrive because of the weaknesses in Drupal.org -- that is, that they create a vacuum that we fill -- but it's not really true. After all, Apple's documentation is pretty good, but that supports outside writers rather than cannabilizing their work. In a healthy project, there's always a new audience to reach. But we outside doc providers have an advantage over Drupal.org: a clear field. Arson is unnecessary, and will put no toxins in the soil. Each building we create on these virgin plots can reflect a different architecture, each fitting a distinct family of users. That's why I think it's great that the Lullabots' CCK and Views videos will be available alongside my own: Theirs reach a certain audience, while mine will reach a different audience. And both of us can only do what we do because of the base provided by Drupal.org's documentation. Together -- we outside doc providers and Drupal.org -- we all grow the Drupalsphere.
Sample Partners
Poll
Who's online
Online users
- miroth698
- Bennie4489
- etgz00050
- eugen0s4
- pingmei3301
- milian5054
- mengwen2755
- xo7qnf924
- Edmund0h1
- zhunwena4v
Recent comments
-
Friday, May 18, 2012 - 13:36
-
Friday, May 18, 2012 - 13:36
-
Friday, May 18, 2012 - 13:36
-
Friday, May 18, 2012 - 13:36
-
Friday, May 18, 2012 - 13:36

Comments
Kobe Bryant (Blessed May 1,
Kobe Bryant (Blessed May 1, 1978)Jimmy Choo Shoes is usually an Us filming protect Jimmy Choo Sale exactly who represents with the Are generally Lakers from the NBA. Jimmy Choo Sandals Sale Bryant relished a very good school Jimmy Choo Boot field hockey vocation in addition to manufactured fast news as soon as he / she Jimmy Choo Flat decided to go within this NBA when university. Maybe you've Jimmy Choo Wedges settled almost any attentions to help Kobe Bryant shoes and boots? As we learn, Kobe shoes and boots usually are exclusive intended for them to help rejoice his or her astounding achievements with judge. Informed Nike include unveiled several Cheap Jordans many years in addition to a variety of varieties fantastic NBA field hockey gambler Kobe Bryant public trademark Cheap Jordan Shoes, Retro Jordans include looked after the highest location wanting to buy Cheap Air Jordan 11 ages intended for they may produce swiftness, Jordan Retro 7 toughness, enhanced mobility, footing, at ease, Jordan Retro 5 setting up, in addition to service, New jordans 2011 for example. Nike Zoom lens Kobe INTRAVENOUS prompted because of the Mamba actions connected with Kobe Bryant, Cheap air jordans in addition to rich in the modern Nike technological know-how, Kids Jordans this Nike Zoom lens Kobe INTRAVENOUS running shoe available represents, Kobe Bryant Shoes together with available models all the other contenders. Kobe VII That has a luxurious, small page in addition to a increased exposure of swift problem, Nike Zoom Kobe 4 it is just one running shoe intended for the final with effectiveness. Kobe VI Kids -Lightweight, super-responsive effectiveness shock reduction -Kobe Olympic Shoes Flywire superior intended for light in weight service Kobe Bryant Shoes -Zoom technological know-how from the hindfoot intended for rapidly, Kobe Shoesoff-the-mark activities --.
Woah this weblog is magnificent i love reading you
Woah this blog is wonderful i like studying your articles. Stay up the good paintings,piumini moncler 2011 online! You know,buy windows 7 ultimate product key, many individuals are searching around for this information,Microsoft Office Professional 2010, you can aid them greatly.
related article:
It's really a great and helpful piece of info
It's really a great and helpful piece of information. I'm glad that you just shared this useful information with us. Please keep us up to date like this. Thank you for sharing.,fashion rings
related article:
So far, Mr. Tebow has worked
So far, Mr. Tebow has worked with brands like Louis Vuitton Alma MM M93595 Jockey, Nike and EA Sports, though some industry professionals say that he will have to come to peace with New York and what it represents if he is to thrive here. I don't think Louis Vuitton Artsy GM outlet that this guy is going to be first pick in New York, said Kelly Cutrone, the founder of People's Revolution, which recently handled the fashion shows for Jeremy Scott and Nicholas K. Do you want him front row at Dolce men's? I don't. After all, louis vuitton handbags outlet is very, very to the right, Ms. Cutrone said. He doesn't believe in abortion or a woman's right to choose. That's problematic, she explained, particularly artsy louis vuitton handbag in a city rife with empowered women who make their own money (not Bible Belt beauty queens), gay men and people who support gay and lesbian rights — the very people who Louis Vuitton Speedy 30 outlet run the fashion industry. Asked if she thought Mr. Tebow might receive the Victor Cruz treatment, Ms. Cutrone said, I don't think Anna Wintour is going to be jogging over there. Spring weather usually tosses a lot of bad fashion louis vuitton speedy handbags trends onto the city's sidewalks. But this year, with our strangely early spring, the journey between my house and Bergdorf's is absolutely perilous cheap Louis Vuitton Belts. I worry — I do! — about those late-middle-aged women in super-high platforms and skinny J Brand jeans. A ballerina in toe shoes would have more contact with the pavement than these babes do. Women love platform shoes, for their Louis Vuitton purses sense of superiority and comfort (relative to other high heels); I love platforms. For 20 years I had a favorite pair of Lagerfeld black suede platforms — from the era of Louis Vuitton Monogram purses Karl Lagerfeld's high-fashion label, with crisscross ankle straps — that almost every year I left at Shoe Service on West 55th Street for a perk-up. As men know, good shoes can be repaired Louis Vuitton 4 KEY HOLDER M93517 and worn for a long time, and the Lagerfeld platforms, aside from being well made, were a classic sin trap style — sexy and shapely but rather modest in height. A decade ago it probably louis vuitton sarah wallet became obvious to me that I couldn't replace them, not in style or quality, and certainly not in cost. It wasn't just that platforms became absurdly big — like a giant Idaho potato wedged Louis Vuitton Zipp Wallet under the ball of your foot — or that the height of the stiletto heel seemed to almost taunt the wearer (or victim?). Rather, these new platforms ceased being feminine and interesting. They were louis vuitton luggage consistently of a type: sleek, aggressive, challenging. This trend started six or seven years ago, as part of the dominance of accessories, and it hasn't stopped. In fact, it's gone further mainstream, to judge by the feet I see most Louis Vuitton Travel KEEPALL 50 days on Fifth Avenue. http://www.louisvuittonoutletfans.com/ Dami
There's No Business Like Snow Business
Television was an invention with the aim of Rolex replica had broad based charm which gave it great for profit potential. put Rolex replica silver on't hand up. replica Rolex This is a earth of specialty. For your trouble, you will get somewhere in the neighborhood of $15 to $50 and it's not unheard of to get more pro some offers. People working calm preserve change Rolex replica diamond mountains. That long for give your client a rough estimate. Should your article be discarded, the directory almost until the end of time sends you an e-transmit amid the reason for rejection. dress nicely at what time you turn up and meet your sponsors and voyage organizers (remember you have only once shot at a essential impression). Google preserve link a number of matter in photographs. 4%. Not too several. Shout Ad:There is a fake Rolex shout container where you can position some text the for your ad to have further exposure. This would not look enjoyable for you and you would probably lose your charge. So various of us nick ourselves despondent in the dumps. 1. Complete a simple enterprise financing application, go through standard due diligence as you would any key of financing, and execute a financing document which in effect collateralizes the SRED for your SR&Ed loan. Indeed, to assess the valid value of a potential sale, you must compare projected expansion and excise ramifications against an investment portfolio rolex replica submariner created on or after swiss Rolex replica sale proceeds after taxes. This inform in addition to bloody encounter resulted in the sinking of the HMS cover with the loss of 95 officers in addition to 1,324 seamen. No commerce opening online will perform without some money and dedication. Stop and take part in a coffee, go for a quick walk around the block, go for a drive..
Cheap Oakley Sunglasses
Extreme sports brand Classic Oakley Sunglasses Frogskin the summer of 2012, a new color to meet with you, Cheap Oakley Sunglasses including the fully transparent frames with purple lenses and Oakley Sunglasses Cheap white frames with orange lenses of fresh combinations, Cheap Oakley Sunglasses full of strong summer flavorstyle, classic design of the Cheap Oakley Sunglasses whole black with black lens and purple different choices of friends you want to increase the heat of summer accessories please refer to Jimmy Choo Outlet!
Great post
Wonderful submit,Acheter Windows 7, very informative. I'm wondering why the other specialists of this sector do not realize this. You must proceed your writing. I'm confident,Genuine Windows 7, you have a huge readers' base already,Windows 7 Serial!|What's Going down i'm new to this,Windows 7 64 Bits, I stumbled upon this I have discovered It absolutely useful and it has helped me out loads. I hope to contribute & assist different customers like its helped me. Great job.
ralated article:
I really like your writing very so much
hello,Acheter Windows 7!,I love your writing so much,Windows 7 Familiale Premium! percentage we communicate extra about your post on AOL? I require an expert in this space to resolve my problem. Maybe that is you,Windows 7 Product Key! Having a look ahead to peer you.
ralated article:
Somebody essentially help to make seriously posts
A person essentially assist to make severely posts I might state. This is the very first time I frequented your web page and up to now? I surprised with the analysis you made to create this actual put up amazing. Magnificent task,Windows 7 Ultimate Key!
ralated article:
Unquestionably imagine that which you stated
Undeniably imagine that that you said. Your favourite reason appeared to be on the net the simplest factor to take note of. I say to you,Windows 7 Home Premium, I certainly get annoyed at the same time as folks consider worries that they just don't realize about. You managed to hit the nail upon the top and also defined out the whole thing with no need side effect ,Activation Windows 7, other people can take a signal. Will probably be back to get more. Thanks
ralated article:
just become alert to your weblog via Google
Hello there,Clé Windows 7 Professionnel, just become aware of your blog through Google,Windows 7 Serial, and located that it is truly informative. I am gonna watch out for brussels. I'll appreciate when you proceed this in future. A lot of people can be benefited out of your writing. Cheers,Clé Windows 7 Ultimate!
ralated article:
Great blog here
Nice weblog here,Windows 7 Pro! Also your site rather a lot up very fast,Clé Windows 7 Ultimate! What web host are you using? Can I am getting your associate link in your host? I want my site loaded up as fast as yours lol
ralated article:
Pretty component to content
Pretty section of content. I just stumbled upon your blog and in accession capital to say that I get in fact enjoyed account your blog posts. Any way I'll be subscribing for your augment and even I fulfillment you get admission to consistently fast.,Activation Windows 7 Ultimate
ralated article:
Remarkable issues here
Tremendous issues here. I am very happy to look your post. Thank you so much and I am taking a look forward to contact you. Will you please drop me a e-mail?,Genuine Windows 7
ralated article:
Hi my family member
Hello my friend,Windows 7 Professionnel! I wish to say that this article is awesome,Clé Windows 7, nice written and come with almost all significant infos. I'd like to look more posts like this .
ralated article:
Wonderful issues altogether
Wonderful issues altogether,Clé Produit Windows 7, you simply gained a logo new reader. What would you suggest in regards to your publish that you made a few days ago? Any certain?
ralated article:
That is really interesting
This is really fascinating,Clé Windows 7 Professionnel, You are an overly professional blogger. I have joined your feed and stay up for looking for extra of your magnificent post. Also,Activation Windows 7, I've shared your site in my social networks
ralated article:
You understand thus considerably in terms of this
You already know thus significantly with regards to this subject,Windows Ultimate, produced me personally believe it from numerous numerous angles. Its like men and women are not involved unless it is one thing to do with Girl gaga,Genuine Windows 7! Your own stuffs great. All the time care for it up,Windows 7 Home Premium!
ralated article:
Somebody essentially lend a hand to make seriously
Someone necessarily assist to make seriously articles I'd state. This is the first time I frequented your website page and thus far? I amazed with the analysis you made to create this particular post amazing. Fantastic process,Acheter Windows 7!
ralated article:
fantastic blog layout
Wow,Activation Windows 7 Ultimate, marvelous weblog layout,Windows 7 Key! How lengthy have you ever been blogging for? you make running a blog look easy. The total glance of your web site is excellent,Windows 7 Keygen, as smartly as the content material,Activation Windows 7!
ralated article:
It is actually a great and useful piece of info
It is actually a nice and useful piece of information. I am glad that you shared this useful info with us. Please keep us up to date like this. Thank you for sharing.,Cheap Links Of London Charms
related article:
Excellent blog right here
Excellent weblog here,links of london uk! Also your web site rather a lot up very fast,links of london jewellery! What web host are you the usage of? Can I am getting your associate hyperlink on your host? I want my web site loaded up as fast as yours lol
related article:
You are actually a just right webmaster
You are really a excellent webmaster. The web site loading speed is amazing. It sort of feels that you are doing any unique trick. In addition,links of london sweetie bracelet, The contents are masterpiece. you've performed a magnificent process in this topic,links of london uk!
related article:
You've done an incredible job
Hey there,links of london sweetie bracelet, You've performed a great job. I'll certainly digg it and for my part recommend to my friends. I am sure they will be benefited from this website.
related article:
i think that i noticed you visited my blog thus i
Hello,links of london friendship bracelet sale, i believe that i noticed you visited my site so i came to go back the desire?.I am attempting to find things to improve my site,links of london bracelets!I assume its ok to make use of a few of your concepts,cheap links of london friendship bracelet!!
related article:
Good day very nice blog
Good day very cool blog,links of london!! Guy .. Excellent .. Wonderful .. I will bookmark your blog and take the feeds additionally?I'm satisfied to find numerous useful information here in the post,links of london bracelets sale, we need develop more strategies on this regard,Links Of London Cheap, thanks for sharing. . . . . .
related article:
Wonderful put up
Fantastic submit,links bracelets, very informative. I ponder why the other specialists of this sector do not realize this. You must proceed your writing. I am sure,Links Of London Charm Sale, you have a huge readers' base already,links of london friendship bracelet!|What's Happening i'm new to this,cheap links of london, I stumbled upon this I have found It absolutely useful and it has aided me out loads. I am hoping to give a contribution & aid other customers like its aided me. Good job.
related article:
I think that is one of the such a lot significant
I feel this is one of the most significant information for me. And i am satisfied reading your article. But should commentary on some basic issues,links london, The website style is perfect,links bracelet, the articles is truly excellent : D. Good activity,links of london, cheers
related article:
I have just been looking for information about th
Thank you,links bracelets, I've recently been searching for info about this topic for a while and yours is the best I have found out till now. But,links of london sweetie bracelet, what concerning the conclusion? Are you certain concerning the supply?|What i don't realize is actually how you are no longer really much more well-favored than you might be right now. You're very intelligent.
related article:
Wonderful beat
Excellent beat ,Microsoft Office 2007 Activation! I would like to apprentice at the same time as you amend your website,Windows 7 License, how can i subscribe for a weblog web site? The account aided me a applicable deal. I have been tiny bit acquainted of this your broadcast provided brilliant clear idea
related article:
Wonderful points altogether
Wonderful points altogether,windows 7 product key, you simply gained a new reader. What may you suggest about your put up that you just made a few days in the past? Any positive?
related article:
I like the helpful info you provide on your articl
I just like the valuable information you supply on your articles. I will bookmark your blog and check once more right here frequently. I'm relatively certain I'll learn many new stuff right here,Windows 7 Activation! Good luck for the following,Office 2007 Serial!
related article:
Woah this blog is wonderful i like studying your a
Woah this blog is fantastic i love studying your posts. Keep up the good paintings,Windows 7 X86 Key! You know,Windows 7 Ultimate Activation Key, lots of people are looking round for this information,Microsoft Office 2010, you can aid them greatly.
related article:
Heya i am for the first time here
Heya i'm for the primary time here. I found this board and I in finding It truly helpful & it helped me out a lot. I am hoping to provide one thing again and aid others like you aided me.,Windows 7 Home Premium Serial
related article:
You understand therefore significantly in terms of
You already know thus considerably when it comes to this matter,2007 Microsoft Office Product Key, produced me for my part believe it from a lot of varied angles. Its like men and women don't seem to be interested except it is something to do with Woman gaga,Microsoft Office Professional Plus 2010 Product Key! Your individual stuffs outstanding. Always handle it up,Microsoft Office 2010 Activation Key!
related article:
Today from i St Patrick’s Day Independent No
Tagged in: i graphic,“Death to Cable” James Undy Independent Eagl,Utah Jazz Hats Recent Posts on Notebook This Picture Can Seriously Damage Your HealthCaught& Social: Captain Jack curses bad backToday from i: Richest people in BritainReview of Doctor Who 'The Curse of the Black Spot'Think. Think again. Think harder.
i: St Patricks Day” width=”630″ height=”567″ title=”Today from i: St Patricks Day photo” />
Great weblog here
Nice weblog right here,Windows 7 Activation Key! Additionally your site quite a bit up fast,Windows 7 Professional Activation! What web host are you the use of? Can I get your affiliate link in your host? I want my website loaded up as fast as yours lol
related article:
Great post
Excellent post. I used to be checking constantly this weblog and I'm impressed,Microsoft Office Product Key 2007! Extremely helpful info specially the last section :) I care for such info a lot. I used to be seeking this certain info for a very long time. Thanks and good luck.
related article:
I love your writing very much
hi,Office Professional 2007 Product Key!,I love your writing so much,Window 7 Home Premium Product Key! share we keep up a correspondence more about your post on AOL? I require an expert in this house to resolve my problem. May be that's you,Office 2007 Serial! Taking a look ahead to peer you.
related article:
Thanks for some other informative website
Thanks for another informative blog. Where else may just I get that kind of information written in such an ideal way? I have a venture that I'm simply now working on,Office 2010 Serial Key, and I've been at the look out for such info.
related article:
Nice blog right here
Nice blog here,Windows 7 Ultimate Activation! Also your website rather a lot up very fast,Windows 7 Home Premium Product Keys! What web host are you the use of? Can I get your affiliate hyperlink to your host? I want my web site loaded up as fast as yours lol
related article:
Normally I do not learn post on blogs
Usually I don't learn post on blogs,Windows 7 Serial, but I wish to say that this write-up very compelled me to try and do it,Win7 Activation! Your writing taste has been amazed me. Thanks,Microsoft Office 2010 Professional Plus Product Key, quite nice post.
related article:
You're truly a just right webmaster
You are actually a excellent webmaster. The web site loading velocity is amazing. It kind of feels that you're doing any unique trick. In addition,Win 7 License, The contents are masterpiece. you have done a magnificent task on this subject,Office 2010!
related article:
Remarkable things here
Tremendous things here. I'm very glad to look your post. Thank you a lot and I am taking a look ahead to contact you. Will you please drop me a e-mail?,Microsoft Office Professional Plus 2010 Activation Key
related article:
I just couldn't depart your web site before sugges
I just could not go away your website prior to suggesting that I actually loved the standard information a person supply for your guests? Is gonna be again regularly to inspect new posts,Office 2007
related article:
You are in reality a just right webmaster
You're really a good webmaster. The web site loading pace is amazing. It kind of feels that you're doing any unique trick. Also,Office 2010 Professional Plus Product Key, The contents are masterwork. you have done a fantastic task in this topic,Activate Windows 7 Ultimate!
related article:
You have performed an incredible job
Hey there,Win 7 Home Premium Key, You've done a great job. I will certainly digg it and in my opinion recommend to my friends. I am confident they will be benefited from this site.
related article:
You actually make it seem so easy along with your
You actually make it appear so easy with your presentation but I find this matter to be actually something that I feel I might by no means understand. It sort of feels too complex and very extensive for me. I am having a look ahead to your subsequent publish,Windows 7 Professional Key, I'll try to get the cling of it,Windows 7 Professional Activation Key!
related article:
Woah this blog is wonderful i like reading your po
Woah this blog is wonderful i love reading your posts. Stay up the good paintings,Buy Windows 7 Activation Key! You realize,Windows 7 Home Premium, a lot of individuals are hunting around for this info,Office 2007 Professional Product Key, you can aid them greatly.
related article:
I discovered your website by way of Google whilst
Hello there,Microsoft Office 2010 Serial, I found your site via Google while looking for a comparable topic,Windows 7 Home Premium, your website came up,Window 7 Home Premium Product Key, it looks good. I've bookmarked to myfavourites|added to mybookmarks.
related article: