[documentation] A New Approach to Drupal Tutorials

Nick Lewis nick at smartcampaigns.com
Sun Jan 15 20:06:23 UTC 2006


Charlie, you must be pretty far ahead of your time. So what's a good 
next step? I could setup a proof of concept site today on my server, so 
that we're all on the same page in so far as what we're building and how 
it would work.

I think moderation of the posts that come through would serve less as a 
protectionary measure, and more as a way to keep the info well 
organized. THe big weekness of feeding in posts, usually, is that it 
gets thrown together in a page of "blog barf"(as one of my clients called).

Does this sound like a reasonable next step?
-Nick

Charlie Lowe wrote:

>
>
> Nick Lewis wrote:
>
>> Here is a really nutty idea. I regularly write drupal tutorials at my 
>> blog, and file them under the term "drupal tutorials":
>> http://nicklewis.smartcampaigns.com/taxonomy/term/177
>
>
> I don't think this is nutty at all. I suggested 2 1/2 years ago that 
> we think about using Drupal aggregation as a method to push content to 
> a site rather than seeing it as a pull technology:
>
> http://cyberdash.com/a-blog-hub-using-drupal-to-create-a-better-community-weblog 
>
>
>
>>
>> I've been asked a couple of times to publish some of them at 
>> drupal.org, but I am a busy and lazy person and haven't really 
>> figured out how to do that. I suspect many of my fellows who write 
>> drupal tutorials are in similar situations. However, we now have some 
>> handy modules like aggregator2 that allow us to take a creative 
>> alternative approach:
>>
>> Using aggregator2 we could take in feeds from drupal developers who 
>> write tutorials (and who give drupal.org permission). 
>
>
> Permission would (should) be granted by using the CC license that 
> drupal.org uses.
>
>>
>> So aggregator2 would feed in new tutorials, and save them as full 
>> fledged nodes at drupal.org. We'd probably at first leave the nodes 
>> unpublished as a distinct node type in the submission queue. When a 
>> new tutorial pops up, all documentation people would have to do is 
>> review it, and file under whatever appropriate taxonomy term they 
>> choose. The end result could be a properly reviewed, organized 
>> library of articles that is created with minimal effort on the part 
>> of documentation writers, and minimal barriers for the writers of 
>> tutorials. This seems to be a win-win that could greatly increase the 
>> amount of quality content on drupal.org while reducing the amount of 
>> work the docs team has to do.
>
>
> I don't believe the submission queue is necessary. Those who are 
> pushing content to Drupal could (should) supply the appropriate 
> taxonomy terms on their own. Once it is on drupal.org, documentation 
> maintainers could choose to add tutorials into the book outline.
> -- 
> Pending work: http://drupal.org/project/issues/documentation/
> List archives: http://lists.drupal.org/pipermail/documentation/
>



More information about the documentation mailing list