Drupal.org Scheduled Downtime Saturday, October 27, 20:00 PDT (Oct 28 0300 UTC)

We will be taking Drupal.org down for up to 60 minutes starting Saturday, October 27, 20:00 PDT (Oct 28 0300 UTC). This outage is to deploy Apache Solr 6.x-3.x. Search results will be incomplete following the downtime as we catch up indexing. Please fo…

Documentation Team Second Quarter 2012 Update

Hello from Jennifer, your outgoing Drupal Documentation Team leader! As I step down as leader of the Documentation team, I wanted to make one last quarterly status update post for the Documentation Team.

Leadership Change

People in the Drupal project are currently exploring Drupal community governance, and among the questions they’ll be thinking about are the leadership and structure of the Documentation Team — so expect an announcement sometime soon! In the meantime, I’m not going to be hosting Documentation Office Hours, but if someone else wants to schedule an Office Hours, go ahead and post an event to the Documentation groups.drupal.org page.

Milestones, Accomplishments, and Projects in progress

  • Lots of content was updated on Drupal.org this quarter. Of particular note:
    • The Accessibility team worked on updating documentation at a sprint in Montreal, including the Creating accessible themes section, and the best practices on accessibility for site builders page.
    • The Multilingual team updated both in-code API documentation and on-line Community documentation for Drupal’s multi-lingual system.
    • The Mobile team organized and created a Mobile guide.
    • I’m sure there are other notable updates that I didn’t mention specifically — 921 different contributors made more than 5000 revisions to documentation pages on Drupal.org this quarter — thanks to everyone who made an edit or created new documentation!
  • There’s a new Community Documentation Moderator group! These dedicated individuals will be overseeing the Community Documentation, and doing tasks that the general Drupal community members do not have the permissions to do (deleting comments, making edits on locked pages, creating URL aliases and redirects, etc.). I’d like to especially thank Boris/batigolix for joining the Moderator group and dealing with so many Documentation project issues in the past few weeks — I’m sure he’d appreciate some help though, so please join him! (Responsibilities and instructions for how to get started: http://drupal.org/node/1588928)
  • The API documentation cleanup sprint from last quarter has continued into this quarter, and a lot of progress has been made! The goal is to bring the Drupal 7 and 8 core API documentation much more in line with our documentation standards. To join in, visit the issue page. There is also a related sprint for general PHP coding standards at http://drupal.org/node/1518116
  • Work on the proposed Curated/Official Docs and Help system has picked up! We have an issue to track progress on building the system, and Google Summer of Code participant Gergely Tamás Kurucz (temaruk) is working on a major component this summer. WorldFallz has also just volunteered to work on the workflow piece of the project, so hopefully around the end of the summer, we’ll be able to deploy the first phase of the system, and start writing “official/curated” documentation. But we will still need some programming help — check the tracking issue for more details.
  • The “Books about Drupal” section is being revised to have a new content type and a View, instead of being a set of flat HTML pages. Lowell/LoMo has been working on that, and we hope to get it finished and deployed on Drupal.org in the next few weeks. Issue: http://drupal.org/node/1487988
  • Many members of the Drupal documentation team collaborated last quarter on proposing an update to the sidebar navigation for the Community Documentation. We reached consensus that we would like to have +/- expand/contract ability on the sidebar, so that people searching for documentation could more easily drill down into the book structure to find pages of interest. But we need some help: evaluating existing modules to see if they will work for us, and if not, building a module that will. If you’d like to help, the issue is: http://drupal.org/node/1508832
  • The API module (the module behind http://api.drupal.org, the programmer API documentation reference site) has been ported to Drupal 7. I did the primary port, and several people contributed by testing it out and/or posting patches for bugs they found. api.drupal.org should be running Drupal 7 sometime soon! The next new features planned for the site are to get more contributed modules visible, make it work correctly with PHP namespaces (which are extensively being used in Drupal 8), and replace the hard-to-maintain Form API reference with an automatically-generated page (and in-code comments). If you’d like to help with these efforts, check the API module issue queue.

Next Steps

If you’re interested in helping with Drupal documentation:

Drupal.org Scheduled Downtime Monday, July 2 at 6:00 PM PDT (July 3 01:00 UTC)

On Monday, July 2 from 6:00 PM to 6:30 PM PDT (01:00 to 01:30 UTC), drupal.org will be briefly brought down for updates. The main website, drupal.org, will be inaccessible, as will SSH-based access, both read and write, to all Git repositories hosted o…

New Drupal 7 core co-maintainer: David Rothstein

I selected Angela “webchick” Byron as my co-maintainer for Drupal 7 back in DrupalCon Szeged in August 2008. Since then, together we shepherded efforts of 1,000 core contributors to create Drupal 7, got the release out the door in January of last year,…

Drupal.org Scheduled Downtime Monday, May 7, 5:00 PDT (May 8, 00:00 UTC)

Drupal.org and its sub-sites (api.drupal.org, groups.drupal.org, etc) will be going down for 20 minutes Monday, May 7, 5:00 PDT (May 8, 00:00 UTC). This maintenance window will be used to upgrade our single sign on system. Please follow the @drupal_inf…

Documentation Team 1st Quarter 2012 Update

Hello from Jennifer, your friendly Drupal Documentation Team leader! It’s time for a quarterly update on what’s happening in the Documentation team.

First off, I just want to remind everyone that I’m still planning to step down as Documentation Team Leader at the end of 2012. If you’re interested in becoming the co-leader or assistant leader now, and taking over at the end of 2012 as the main team leader, see http://groups.drupal.org/node/203258 for more information. It would be good to find someone soon!

Events

  • The Documentation Team is currently holding weekly “Documentation Office Hours”—one-hour IRC meetings on Tuesday afternoon (North American time), open to anyone for questions and discussions about contributing to documentation. This schedule is likely to change soon; join the discussion about a new time for office hours.
  • The API documentation cleanup sprint from last quarter has continued into this quarter. The goal is to bring the Drupal 7 and 8 core API documentation much more in line with our documentation standards. To join in, visit the issue page.

Milestones and Accomplishments

  • Lots of content was updated on Drupal.org this quarter. Of particular note:
    • There used to be a “Community and Support” link in the top navigation of Drupal.org; now there are separate Community and Support links, and the Support page has been completely redone (a redesign of the Community page is also in the plans). Hopefully this will help people new to Drupal connect with the help they need to get started. Thanks to Lisa Rex, David Hernandez, and others for making this happen!
    • The Omega theme project organized a group to update the Omega section of the Community Documentation.
    • The Media module project organized a group to update the Media documentation.
    • An effort is underway to create a Mobile section in the documentation.
    • We started a New Contributor Tasks section on Drupal.org. This is a place where people new to contributing to Drupal can go to find meaningful and doable tasks to start with. If you have ideas for the section, there’s a page describing how to add to it (with templates), and a suggestions page too.
    • 712 different contributors made a total of 3976 revisions to documentation pages on Drupal.org. Wow! (I have a new statistics page that totals this up). Apologies if your project didn’t make it into the list above — there’s a lot going on and I can’t keep track of it all!
  • Neil Drumm and I (with the help of other patch contributors) are continuing to make updates to the software for http://api.drupal.org. This quarter, there were major improvements to the linking and references features of the site — check it out if you haven’t been there lately! If you would like to work on the API module, check out the issue queue (http://drupal.org/project/issues/api) or find jhodgdon in IRC to get oriented.
  • I was given permission to commit Drupal Core 7/8 documentation and coding standards patches in February, and to help out in case of “Core Is Broken!!” emergencies. Hopefully this will lessen the burden on Angie, Nat, and Dries, freeing them up to concentrate on bugs that improve the Drupal software functionality.

Docs Infrastructure

Last year, the Docs Team (or at least its leadership) got a bit discouraged about Documentation infrastructure improvements taking quite a while to get deployed to Drupal.org. But now there’s a new process for getting improvements deployed, and Neil Drumm is working on them with hours funded by the Drupal Association. So, I’d like to get us working on improvements to “docs infrastructure” (tools, navigation, etc. for Drupal documentation writers and users) again.

I started working on that this quarter, and several small things were deployed. That went well, so there are now more in progress. Two that we hope to get done soon are a Docs Team effort to have better navigation for Community Docs, and LoMo’s project to replace the Books page with a content type/View. Join in the discussion and/or help out!

And as a preview, this summer I would like to really get working on the “curated docs” we’ve been talking about for a year or more… Watch http://groups.drupal.org/documentation-team for updates!

Next Steps

If you’re interested in helping with Drupal documentation:

Docs Team 4th Quarter 2011 Update

Hello from Jennifer, your friendly Drupal Documentation Team leader! It’s time for a quarterly update on what’s happening in the Documentation team. As you probably heard, Ariane’s role in the Documentation Team has changed, and she is no longer my…

Documentation Team Leadership Change

Hi everybody -
Hope you all had a great holiday, and are easing into 2012 nicely! I’ll cut right to the chase with this announcement: effective pretty well immediately (as this has been in the works for a little while now), I’m stepping down as Documen…

Greg Knaddison to lead the Drupal Security Team

The Drupal Security Team was originally created in 2005. Though we handled security issues before that, we didn’t have a team with proper infrastructure until then. At that time, Károly Négyesi (chx) was the team leader. In July 2006 chx changed his …

Scheduled Maintenance Window: git.drupal.org/drupal.org

git.drupal.org, drupal.org and our sub-sites have a scheduled maintenance window on Tuesday November 15th from 5PM PST to 7PM PST (UTC-8). Note that this is not a downtime window for drupal.org, but a period of possible instability. git.drupal.org and …