[documentation] Some Background/Strategy Help Needed re: "Drupal Cookbook"
Shai Gluskin
shai at content2zero.com
Tue Mar 31 01:57:09 UTC 2009
Hi gang,
I did some work on the "title" page of the Drupal Cookbook today...
http://drupal.org/handbook/customization/tutorials/beginners-cookbook
I just jumped in, but now I'm seeing some questions I'd like to ask the
group.
The book is written in a very strong "I" voice. Who is it? I couldn't quite
tell from the revisions. I'd respectfully like to tell that person that I'd
like to put some editing work in.
Also, it seems to me like the "I" voice should be removed. That doesn't fit
the style guide and it seems kind of weird, especially since those pages
don't have authors anyway.
Another thing that is weird... the Cookbook is nested under "Beyond the
Basics" but it is also specifically referred to as "For beginners."
If there were plans to retire or replace the "Cookbook" -- I don't want to
waste time. But otherwise, I'd be happy to put some more work into it.
I'd be interested to feedback on the work that I did today on the first
page.
http://drupal.org/handbook/customization/tutorials/beginners-cookbook
I left pretty good notes in the log, and of course you could dif it. I
changed the order of things, mostly took stuff out. The place where I added
the most was in the terms definition section. I think giving some meet there
is helpful, especially for beginners, in lays an important foundation.
Thanks,
shai
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.drupal.org/pipermail/documentation/attachments/20090330/77f7afce/attachment.htm>
More information about the documentation
mailing list