Closed javiereguiluz closed 2 months ago
The mention should be expanded IMO to make it clear that whitespace control is not a drop-in replacement of spaceless
. It is a different feature (that might satisfy the need of the project if their intent was to remove spaces coming from indentation in the Twig template)
@stof in Symfony Docs, in similar situations, we don't do that because it's like duplicating some doc content. Also, the admonition messages look bad when they are too long.
I'd say it's better to just link to the new docs so visitors can quickly learn about it ... but if Twig Docs does differently, tell me and I'll update this. Thanks.
Well, the message as is can make people think that this is a direct replacement, while it is a totally different feature.
I'm not asking to duplicate the documentation of whitespace control in the admonition message. I'm only asking to make it explicit that whitespace control is not a direct replacement.
Thank you @javiereguiluz.
When a feature is deprecated, it's recommended to provide an alternative for it (or mention that there's no alternative).
So, let's mention the whitespace control features in the deprecation message of the
spaceless
filter.