contributers guide

THIS PAGE IS A WORK IN PROGRESS... It should have more information shortly!

This document covers updating documentation (online and API) for the Symfony component of Drupal (adopted in Drupal version 8).

Background and Overview

In Drupal version 8, the Drupal Core project adopted several third-party libraries into its source code, including the Symfony web development framework. The Symfony library is under directory core/vendor/symfony in the Drupal core source code (version 8), and other PHP-based libraries are in other directories under core/vendor. There are also third-party JavaScript libraries in Drupal, such as JQuery (which has been part of Drupal for many versions); these have traditionally been located in the "misc" directory, mixed in with Drupal-native JavaScript libraries.

If you find an error or omission in Symfony's documentation and would like to contribute to the Drupal and Symfony projects by fixing it (or at least pointing it out), the basic steps are the same as contributing to the Drupal API documentation:

Advanced Asset contribution / management widget provides next functionalities:

• In-place (in widget) Asset management (create / edit / delete with native Drupal interfaces) of any Asset type.
• Asset search interface, with opportunity to filter by various fields (Asset's type, author, title, date, etc).
• Advanced listing of the Assets (2 modes of display) with pagination and in-place preview option.
• Drag & drop of Assets from the listing inside widget into Entity reference field (with Media Asset target type) or WYSIWYG editor with enabled Asset plugin.
• Other

Expanded widget

Search interface

Listing and preview

Drag&drop option

You still are able to override Asset display settings after embedding Asset into CKEditor.
All optional fields from the Asset entity type and Display settings can be modified without any impact on the original Asset.

Just call the context menu Override Asset by doing right mouse click on the embedded asset zone and do the modifications.

If user, who embeds Asset has a permission to modify original Asset, he will see "Edit Asset" button, which will open Edit Asset interface. Note that modification of required field in the original Asset will cause an update of display of this Asset everywhere, where this Asset is embedded.

Also "Cut Asset" and "Remove Asset" buttons are available in the context menu.

This section is intended to provide direction for Drupal.org content, particularly documentation and general information pages related to Drupal, Drupal.org, and our community.

In particular, the content style guide has guidelines for writing, voice, HTML markup and more.

Guidelines for screenshots and images, online documentation structure, commenting do's and don'ts, and documentation copyright information can be found in the content overview section.