Announcements module overview
The Announcements module provides a feed of announcements about the Drupal project and Drupal Association programs in Drupal core.
Content
The purpose of this feed is to provide a channel for outreach directly to Drupal site owners. This content must be highly relevant to site owners interests, serve the strategic goals of the project, and/or promote the sustainability of the project and the Drupal Association.
Only the title, teaser and date information are displayed directly in the Drupal UI, and these teasers link to the full content on Drupal.org.
Featured content
Featured content is sticky to the top of the announcements feed, and is given more visual weight by including teaser text and different styling. Featured content is reserved for posts that are of special importance or are time sensitive. Such content might include highlights about upcoming features in the next major version of Drupal, migration and support options for users still on legacy versions, or time sensitive communications from the project or the Drupal Association.
Regular content
Regular content is displayed in order of publication date and given less visual weight, with no teaser text. Regular content must still be of particular importance to site owners, but less so than featured items. This content might include important information about features or changes in a minor version of Drupal, surveys for end-user input, or information about DrupalCon and Drupal Association membership.
Source
The Announcements module sources it's content from: https://www.drupal.org/about/announcements
These announcements include a semver version constraint parameter, so that if the post is of interest only to users on a particular version or range of versions it can be displayed just to them.
Subject to the governance policy, content can be added to this feed by:
- Being posted directly to: https://www.drupal.org/about/announcements
- Being cross-posted from another source, such as the Drupal core blog: https://www.drupal.org/about/core/blog
Note on publishing to the feed
Once content has been posted or cross-posted to https://www.drupal.org/about/announcements, a drush command must be run by drupal association staff to add it to the json endpoint.
A waiting period of 8 to 24 hrs is recommended after publishing the post before updating the json endpoint, as long as the post is not time sensitive, to catch any final typos that inevitably only get found after publishing.
- The command
sudo -u bender -H drush -r /var/www/drupal.org/htdocs -v drupalorg-update-announcements-json --testwill publish it to the test endpoint: https://www.drupal.org/announcements-this-is-only-a-test.json - The command
sudo -u bender -H drush -r /var/www/drupal.org/htdocs -v drupalorg-update-announcements-jsonwill publish it to the live endpoint: https://www.drupal.org/announcements.json
Governance
Governance of the announcements feed is documented in the Governance Handbook.
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion
