This month in Drupal Documentation
This is the monthly update from the Documentation Working Group (DocWG) on what has been going on in Drupal Documentation. Because this is posted in the Core group, comments for this post are disabled, but if you have comments or suggestions, please see the DocWG home page for how to contact us.
Drupalcon Documentation Sprint
A small group of sprinters gathered on the last day of Drupalcon to work on a couple of Documentation issues. During the sprint the Installation guide was being reviewed for Drupal 8 and there is still work left to process some of that feedback. Furthermore a start was made writing the Theming guide for Drupal 8 (see below for more).
Theming guide for Drupal 8
The theming guide for Drupal 8 has been written almost from scratch and is beginning to take shape. It already covers such topics as:
- Defining a theme with an .info.yml file
- Theme folder structure
- Working With Twig Templates
- Adding stylesheets (CSS) to a Drupal 8 theme
- Creating a Drupal 8 sub-theme
- Using Classy as a base theme
- Adding JavaScript to a Drupal 8 Theme
The theming guide still needs a lot of improvement. So if theming is your thing and you have some spare time this month, then please review it. Every little improvement is helpful. Note that you can edit documentation pages on drupal.org directly and that there is no need to leave comments.
Credits
Sander Tirez's theming guide, many stackexchange Q&A's and various blog posts proved invaluable input for writing the guide.
Thanks for contributing!
Since our last post from October 1 about 280 contributors have made some 1100 Drupal.org documentation page revisions, including 10 people that made 15 or more edits. Thank you batigolix, Pierre.Vriens, SERVANT14, Anthony Pero, camorim, sanchiz, tvn, Pere Orga, LoMo, phenaproxima and all the others and keep up the good work!
Changes to documentation on drupal.org
- The formatting of keywords in the sidebar of documentation pages in drupal.org has been improved.
- The display of the original author of documentation pages has been removed. This was done because in many cases the wrong original author was being shown. Now only the most recent revision authors are being shown.
Documentation Working Group meetings are open
The monthly meeting of the Documentation Working Group is open to anyone who would like to attend. Ping us if you want to join the meeting.
Documentation Priorities
The Current documentation priorities page is always a good place to look to figure out what to work on, and has been updated recently.
If you're new to contributing to documentation, these projects may seem a bit overwhelming -- so why not try out a New contributor task to get started?