Documentation

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.

We have a new project! We're creating a User Guide to Drupal 8. That page has information about how to participate in writing or editing, and we're posting in this group about our meetings (every two weeks) and status updates.

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.

Amber Himes Matz's picture

D8 User Guide Mentoring (IRC: #drupal-docs)

Start: 
2015-08-20 09:00 - 09:30 America/Los_Angeles

Twice a month, we meet in the #drupal-docs IRC channel to chat about the D8 User Guide.

Do you have questions about the D8 User Guide project? Want to get involved? Need help getting started?

Join the User Guide project team (ambermatz, jhodgdon, and eojthebrave) in the #drupal-docs IRC channel, say hello, ask any questions you might have, and get help finding a section to write.

Read more
eojthebrave's picture

This Month in Drupal Documentation - August 2015

It's been a busy month in Drupal documentation land. Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Sorry... because this is posted in the Core group as well as Documentation, comments are disabled.

If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!

Read more
Amber Himes Matz's picture

D8 User Guide Q&A (IRC)

Start: 
2015-08-06 09:00 - 09:30 America/Los_Angeles
Organizers: 

Have questions about the D8 User Guide project? Want to get involved? Need help getting started?

Join the User Guide project team in IRC, say hello, ask any questions you might have, and get help finding a section to write.

New to IRC? See https://www.drupal.org/irc/setting-up

Meeting time in your timezone

Edit: IRC Log attached

Amber Himes Matz's picture

D8 Manual Check-In Meeting (IRC)

Start: 
2015-07-23 09:00 - 09:30 America/Los_Angeles
Organizers: 

Join us in IRC in the #drupal-docs channel on July 23 for info and updates regarding the Drupal 8 Manual Project.

Edit: IRC log attached.

ifrik's picture

This Month in Drupal Documentation - June 2015

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last six weeks: the successful start of the Drupal 8 User Guide and 929 edits on drupal.org.

Read more
jhodgdon's picture

User Guide project - Outline posted!

As you probably know, we're working on creating a User Guide for Drupal 8. We started working on the actual content about two weeks ago, and several topics are in progress. We started writing before we were really sure what the guide should contain, working on a short list of topics we were pretty sure we'd want to include.

Read more
jhodgdon's picture

Drupal 8 User Guide - Inaugural Update

Wow! Thanks to everyone who commented on our proposal to create a Drupal 8 user guide. We read all of the comments carefully, and have made a plan for how to get this manual written, edited, and tested:

Read more
Amber Himes Matz's picture

Kick-Off Meeting: Drupal 8 Manual Project

Start: 
2015-07-02 09:00 - 10:00 America/Los_Angeles
Organizers: 

Join us in IRC in the #drupal-docs channel on July 2 to kick-off the Drupal 8 Manual Project.

Agenda:

For information on how to connect to IRC, you can check out this page: Setting up IRC or post a comment here indicating you need help and one of us will be happy to help you.

jhodgdon's picture

Drupal 8 User Guide Sprint at Twin Cities Drupal Camp (or remote)

Start: 
2015-06-28 09:30 - 17:00 America/Chicago
Organizers: 

As you've probably noticed on https://groups.drupal.org/node/470648 -- we're planning to create a new Drupal 8 User Guide. The Twin Cities Drupal Camp is coming up on June 25-28, and they invited me (along with Joe/eojthebrave who was already going to be there), to jump start the User Guide project by holding a documentation sprint on their community sprints day, Sunday June 28. So, we're going to do this!

Read more

Outline for Drupal 8 User Manual

This outline is designed to go along with the conversation and proposal made by jhodgdon and seen on https://groups.drupal.org/node/470648

  1. Welcome to Drupal
    1.1. Overview
    1.2. Basic architecture
  2. Getting started!
    2.1. System requirements
    2.2. Installing Drupal
    A. Your local environment
    B. Try Drupal in a hosted environment (https://www.drupal.org/try-drupal)
    2.3 Basic site settings
  3. Creating Content
  4. Extending Drupal
    4.1 Finding and selecting Drupal modules and themes
    4.2 Installing
    4.3 Updating
Read more
jhodgdon's picture

Proposal to create a Drupal 8 User Manual

Every time someone does a survey of "What does the Drupal project need?", Documentation comes out as one of the top results, even though we have a large amount of Community Documentation and a comprehensive developer reference with topic pages. One key problem is that for Drupal newcomers, the sheer amount of documentation is overwhelming, and what we have is somewhat lacking in organization, so they don't know where to start in order to learn how to use Drupal.

To mitigate this problem, the Documentation Working Group is proposing to create a new Drupal 8 User Guide, with funding (hopefully) from a Community Cultivation Grant from the Drupal Association.

We're posting the entire proposal below.... We'd love to hear from you between now and June 19, at which point we'll apply for grant funding. Please let us know:
- What do you think of the idea?
- Do you have any suggestions?
- Are you interested in being part of the team that develops the initial manual?

Note: June 19 has passed, and this post is now closed to comments. Thanks for all of the suggestions and offers to help! We'll be in touch!

This post contains a follow up to the proposal here as well as some information about how we're planning to proceed with this project based on all the excellent feedback we received: https://groups.drupal.org/node/472728

Read more
batigolix's picture

This month in Drupal Documention (May 2015)

Here we are again with an update from our Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Because this is posted in the Core group as well as Documentation you can not comment on this post. If you have comments or suggestions, please see the DocWG home page for how to contact us.

Read more
ifrik's picture

This Month in Drupal Documentation - April 2015

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so: a successfull Documentation sprint at DrupalDevDays, and more then 1000 edits on drupal.org.

Read more
tsvenson's picture

Drupal 8 distro development documentation

I was checking out Distribution developers guideto read up on the new API for developing distros with Drupal 8.

Besides the link the the install-profiles, there doesn't seem to exist very much about more advanced distros right now.

Is there any work and/or discussions going on about writing such documentation right now?

Would be grateful for links to more information too.

eojthebrave's picture

This Month In Drupal Documentation (March 2015)

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Sorry... because this is posted in the Core group as well as Documentation, comments are disabled.

If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!

Read more
batigolix's picture

This month in Drupal documentation (February 2015)

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Because this is posted in the Core group as well as Documentation you can not comment on this post. If you have comments or suggestions, please see the DocWG home page for how to contact us.

Read more
Frank Ralf's picture

New Drupal group: DITA Tech Comm CMS

Hi,

There is a brand new Drupal group related to DITA XML-based documentation:

DITA Tech Comm CMS
https://groups.drupal.org/dita-tech-comm-cms

I'm posting this announcement here because the group is still pending moderation and therefore doesn't show yet in the list of new groups. Please join if you are interested in combining DITA and Drupal.

Kind regards,
Frank

ifrik's picture

This Month in Drupal Documentation - January 2015

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Sorry... because this is posted in the Core group as well as Documentation, comments are disabled.

If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!

Read more
jhodgdon's picture

This Month in Drupal Documentation - December 2014

Here's an update from the Documentation Working Group (DocWG) on what has been happening in Drupal Documentation in the last month or so. Sorry... because this is posted in the Core group as well as Documentation, comments are disabled.

If you have comments or suggestions, please see the DocWG home page for how to contact us. Thanks!

Read more
jhodgdon's picture

Drupal 8 Help Review sprint for Global Sprint Weekend, January 17-18

The Drupal community is having a Global Sprint Weekend on the weekend of 17-18 January, 2015. You can join a local sprint in your area, or participate remotely via IRC.

Either way, the Documentation Working Group would like to invite both new and experienced Drupalists to participate in our the Drupal 8 Help Review sprint during this weekend (or at any time)!

Read more
Subscribe with RSS Syndicate content

Documentation

Group categories

Event type

Post type

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds:

Hot content this week