Issue #2910682 by Wim Leers, jhedstrom, damiankloip, dawehner, Grayside: Mark serializer encoders @internal

core/modules/serialization/src/Encoder/JsonEncoder.php

@@ -10,6 +10,10 @@ use Symfony\Component\Serializer\Encoder\JsonEncoder as BaseJsonEncoder;
 
 /**
  * Adds 'ajax to the supported content types of the JSON encoder'
+ *
+ * @internal
+ *   This encoder should not be used directly. Rather, use the `serializer`
+ *   service.
  */
 class JsonEncoder extends BaseJsonEncoder implements EncoderInterface, DecoderInterface {
 

core/modules/serialization/src/Encoder/XmlEncoder.php

@@ -12,6 +12,10 @@ use Symfony\Component\Serializer\Encoder\XmlEncoder as BaseXmlEncoder;
  *
  * This acts as a wrapper class for Symfony's XmlEncoder so that it is not
  * implementing NormalizationAwareInterface, and can be normalized externally.
+ *
+ * @internal
+ *   This encoder should not be used directly. Rather, use the `serializer`
+ *   service.
  */
 class XmlEncoder extends SerializerAwareEncoder implements EncoderInterface, DecoderInterface {