New initiative

jhodgdon's picture

In-Drupal Help: Tours and Topics

Starting in Drupal 4.x, I think, Drupal Core had a capability for a module to provide 1 help topic (which we now in Drupal 8 call a "module overview"), and to add a small amount (typically) of help text at the top of one or more admin pages.

New in Drupal 8, modules and themes have the capability of also providing "tours", which are guided tours of their administrative pages, via the core Tour module.

Read more
jhodgdon's picture

Add videos to User Guide?

Joe Shindelar (eojthebrave) has made a proposal that we add videos to the User Guide! We're soliciting input on this proposal on this issue:
https://www.drupal.org/project/user_guide/issues/2923453
There's a sample video linked in the issue summary on that page.

Please take a look at the proposal and sample video, and respond on the issue if you have comments or questions. (You can add comments here too, but on the issue is preferred.) Thanks!

Read more
Amber Himes Matz's picture

D8 Manual Check-In Meeting (IRC)

Start: 
2015-07-23 09:00 - 09:30 America/Los_Angeles
Organizers: 
Event type: 
Online meeting (eg. IRC meeting)

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.

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: 
Event type: 
Online meeting (eg. IRC meeting)

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.

Read more
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: 
Event type: 
Sprint

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
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
Itangalo's picture

Book "Drupal 7 – the Essentials" being added to the community wiki

I am very happy to announce that I (finally!) am publishing my book Drupal 7 – the Essentials in the documentation section on drupal.org!

The book covers basic and advanced site building with Drupal core, Views, Flag, Rules, Page manager and Panels. So far only "part A" (74 of 324 pages) are published, but I hope to finish it before the end of the week.

If you're curious, check out http://drupal.org/node/1576418.

Read more
jhodgdon's picture

Documentation Office Hours Feb 28 - Moving forward with Curated Docs

Start: 
2012-02-28 13:00 - 14:00 America/Los_Angeles
Organizers: 
Event type: 
Online meeting (eg. IRC meeting)

Our next weekly Documentation Office Hours will be a discussion of how we can push forward with the plans for the "Curated Docs". Other Documentation Infrastructure discussions would also be welcome, but I'd like to concentrate on the Curated Docs. Please sign in and join the discussion!

See above for the time (hopefully in your time zone; if not, check your user profile). The discussion will take place in the #drupal-docs IRC channel.

Read more
jhodgdon's picture

Association is prioritizing site builders...

In case you didn't notice, the Drupal Association has made a list of 6 priorities for 2012. Number 6 is "Make Drupal.org awesome for site builders", and Documentation is a large component of this.

So I just thought I'd make sure the Documentation Team was aware of this discussion:
Original page discussing the 2012 priorities: http://groups.drupal.org/node/197558
Sub-page specifically about this priority: http://groups.drupal.org/node/198708
Association group home page (which also lists these priorities): http://groups.drupal.org/drupal-association

Read more

Outline for Drupal 7 Site Building quick start guide

The Docs Team has put in a proposal to attend the Google Summer of Code Docs Summit/Sprint in October 2011. This conference includes a sprint, and we decided that we would propose building:

A quick start guide to building a Drupal 7 site (with core Drupal and contributed modules), which we've identified as a missing piece in our official Drupal documentation. (We had a beginner's suite building guide for Drupal 5, which was updated somewhat for Drupal 6, but it has issues and needs to be totally rethought.) This new quick start guide would use a fictitious company web site as an example, and go through all of the steps necessary to build a Drupal site (after the initial installation of Drupal -- we already have good documentation on that part). We would then link to this quick start guide from our Drupal documentation home page, and from other pages on Drupal.org (our intent would be for this to live on-line on drupal.org, and to be a fairly prominent piece of documentation, maintained going forward in new versions of Drupal).

What I'd like to do here is make an outline, so we're ready to get to work on this when we arrive (if our proposal is accepted).

Read more
Subscribe with RSS Syndicate content