Welcome! This group is for news and discussions related to Drupal documentation. If you join this group, you'll be signed up to receive email notifications; you can change your preferences on your account page. You can also subscribe to posts via RSS (check the sidebar of this page), and via email using the links at the bottom of this page.
Anyone can contribute to documentation, and the entire Drupal community will benefit from your help! You do not have to formally join a team (or this group) or ask for permission -- just start writing and editing. The Contribute to Documentation section on Drupal.org has more information, and the New Contributors section on Drupal.org has some tasks that will help you get you started.
If you have ideas about how the processes, procedures, and tools for Drupal documentation can be improved, the Documentation Working Group (a committee that is part of the Drupal project governance structure) invites you to make suggestions. Information on how to do that is on the Documentation Working Group home page.
Should we open editing rights to all users?
There is a discussion currently happening on the docs mailing list about potentially opening up editing rights for all authenticated users. The discussion has been happening for about two weeks now and there is a summary post that distills the conversation and outlines next steps. Please feel free to join the conversation on the mail list or come to the next IRC meeting.
Read moreDocumentation sprints for better docs and to grow the team
Edit, October 2 -- This proposal has been passed along to the Knight Foundation for consideration -- http://drupal.org/node/316402. End Edit
This proposal is to request funding to improve Drupal's documentation by conducting documentation-specific sprints. There are two major components to this project:
1) Tackle big Documentation team issues: Gather key people to work on specific documentation issues that will further the goals of the Documentation team, the handbooks on Drupal.org and documentation that ships with the Drupal code.
IRC meeting
Pursuant to the latest scheduling Doodle we will be having a team IRC meeting on the FreeNode network #drupal-docs channel on Sept. 14 at 17:00 GMT (1pm EDT, 10am PDT). the meeting will go for one hour.
The current agenda items:
* The Getting involved handbook: http://groups.drupal.org/node/14517
* Opening editing rights to all auth users: http://lists.drupal.org/pipermail/documentation/2008-August/006191.html
Getting involved handbook
We have announced a new handbook that will be added to the main Drupal Documentation landing page: Getting involved. Read more about it and how you can help at http://drupal.org/node/293455.
Read more
Post your proposed session for DrupalCampLA 2008
This is easy and quick, nothing fancy, no voting - just post your session idea (title) and your name/contact info and show up to present that day! We have sessions open from 10am-2pm each day (Saturday and Sunday) and each session should plan for 45 minutes each.
http://groups.drupal.org/node/12528 (edit wiki page)
If you can't see or edit the wiki page, be sure to join our group which may be required for editing the wiki page.
Read moreScalability Presentation Notes - SFDUG July 2008
I'm posting this as a wiki for others to add notes or links - based on Neil's presentation we attended. I would suggest conversation / disagreement / further discussion about the recommendations herein happen elsewhere - i.e. in the comments, etc. :-)
My notes are now up -Neil
Notes on Scalability
Neil Drumm
SF Drupal User's Group
July 14, 2008
OVERVIEW
Read more
Basic End-User Administrator Training Manual for Drupal 5
This is the Basic End-User Training Manual I've been meaning to contribute for a while. Thanks to my former bosses at Raised Eyebrow Web Studio for giving me the go ahead to rework it and contribute it back to the community!
Read more
Should the Drupal.org Menu-Bar have a Glossary Item, that link to a Glossary and/or Drupal-Dictionary and/or Vocabolary Page?
Article - for a new Drupal Documentation Project
Hi All,
Just after being denied for the proposal of a new Group entry entitled "Documentation Task Force" i was referred
that here is the best place for my efforts:
For those of the Group who does not know my person and motivations, i will suggest to read some posting I already
have contributed on drupal.org to focus on the big problem to get oriented in the Drupal.org ---- DRUPAL HANDBOOKS.
Is GFDL Compatible with GPL?
http://en.wikipedia.org/wiki/GNU_Free_Documentation_License says that GFDL is the counterpart for documentation to http://en.wikipedia.org/wiki/Gpl, so I'm wondering if they are compatible, and if documentation published under GFDL may be packaged with modules in the Drupal.org repository?
Thanks,
Aaron Winborn
http://aaronwinborn.com/
Few Documentation Clarification Requested -- Languages
I really dont know the answer to this, and I notice its not in the Language Documentation.
http://drupal.org/node/11130
http://drupal.org/node/31714
Sessions on Getting Help From The Community Wanted For Drupalcon 2008
My name is Matthew Pare and I'm a Co-Chair for the "Community and Core" track for Drupalcon Boston 2008. Over the last couple of weeks we have been planning and brainstorming to make Drupalcon Boston 2008 the best Drupalcon to date! One of our recommended track session topics is "Getting Help From The Community" and since your viewing this post on the Beginner Documentation group I thought you would be excellent candidates for submitting sessions on the topic.
Read more
Mentoring
Check out this suggestion: http://drupal.org/node/147183
Read moreURL Modules
I've put this together for URLs & and Clean URLs. I'd like to see any other add-on modules under it as well following the same WHEWF (What, How, Example, Why, Further reading.) I will be working on PathAuto tomorrow. I have to stop doing this stuff or I'm never going to get my site up LOL.
URL = Uniform Resource Locator. The text you see, or type in your browser address bar. i.e., http://www.example.com http:// is the protocol your browser uses to find www.example.com which is where the data lives.
Administer >> Site Configuration >> Clean URLs
Read moreTerminology
I finished up the Drupal Simply page (what, how, why with suggested additional reading) today over at the dojo site and promoted it to a book. However when I was re-reading it and trying for beginner eyes I began to wonder if people would understand the words display engine and tried to find what Drupalers called it and couldn't find anything other then Theme. Does anyone know what this part of the system is called other then Theme? I am going to replace display engine with theme engine, but wondered if there was something else it was called.
Shari
Read moreWhat I'd like to see
I've spent my hour and now have to move on to paying work ;-) lol what I like to see simplified is:
Node, what is it and what does it do for you?
Taxonomy, what does it do for you? Also need to cover that it's under Category in the Admin area
Breadcrumb, what is it and what does it do for you?
Creating content. How, and what you can do with it after it's created.
viewfield module
This module allows someone to include on a page of content (node) a search
and display of additional content from a preexisting view.
e.g., you have a content type for CD’s, they include a CCK field for artists. You could create a content type for the artist and include on that content type a viewfield allowing Drupal to find and present any of the CD content types that belong to that artist so you would end up with a content page view of:
Artist information <~~ This would come from the other fields that were on the created content.
Read moreUsing drupaldojo.org
Thanks to Drupal Dojo, we can use the www.drupaldojo.org to hash out the working and how to present the book (pages). Once we have something here, we can move it to the Wiki so that anyone can offer edits. Once something is in solid form we can add it to the Book. Please post here 1st so people know something has been added and also this is also were we can attract newer members so we need to stay within Drupal
Shari
Read moreJust came over
Hi all add1sun, invited me over to co-habitat with ya all on the drupaldojo.org I'm not sure how this will fit in as I'm aiming for simplification vs technical information. I'd love to play around and hopefully others will fix what I'm missing and will give feedback. I've just started over at http://groups.drupal.org/beginner-documentation so I'm not sure who else is going to play with me, but I'll keep plugging along.
Not sure if you want to add a book, or if I should just start up in the wiki area.
Thanks for the invite!
Shari
CCK Widget
What is a CCK Widget?
The final user form (create content) for inputting data (site content) is created using widgets. The admin creates a content type or node (user form), by adding fields via CCK. The admin chooses what widget (field container) to use to collect that data (content). e.g. you want the user to put a number in the field so you select the integer/text widget. Each data type, and the way it can be entered is a widget.
Read more