diff --git a/contributing/code/create_bridge.rst b/contributing/code/create_bridge.rst new file mode 100644 index 00000000000..4c4fce82e22 --- /dev/null +++ b/contributing/code/create_bridge.rst @@ -0,0 +1,55 @@ +Create a new bridge for Mailer, Translation or Notifier Component +================================================================= + +.. admonition:: Screencast + :class: screencast + + Do you prefer video tutorials? Check out the `Contributing Back To Symfony`_ + screencast series. + +Creating a new bridge for a Symfony Component requires a number of changes to the +code and possibly the Symfony documentation. To help the contributors along the way, +we have created this checklist of things to keep in mind. + +Update code +----------- + +* Add the Transport factory to ``UnsupportedSchemeException`` and +``UnsupportedSchemeExceptionTest`` of the component; +* Add the Transport factory to the ``FACTORY_CLASSES`` constant of the component's +``Transport`` class; +* The ``#[\SensitiveParameter]`` attribute should be used for sensitive properties; +* Check if the classes defined in :class:`Symfony\\Bundle\\FrameworkBundle\\DependencyInjection\\FrameworkExtension` is the same as the ones +declared in component's transports configuration; +* The year in the copyright should be the current year. + +Update recipes +-------------- + +* TBD + +Update documentation +-------------------- + +Bridges are not documented with code documentation, you can use the component's +readme file to add some information about how to use it. However components +documentation requires some updates in order to stay up to date. + +For a Mailer Bridge + +* Add the new Bridge in third party transport's list; +* Add the available DSN formats in the relevant list; +* Indicate whether the new Bridge supports tags and metadata; +* If your Bridge supports Webhook add it in its documentation. + +For a Notifier Bridge + +* Add the new Bridge in the list for the relevant channel; +* If your Bridge supports Webhook add it in its documentation. + +For a Translation Bridge + +* Add the new Bridge in the translation providers list; +* Add the available DSN formats in the corresponding list. + +.. _`Contributing Back To Symfony`: https://symfonycasts.com/screencast/contributing pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy