Skip to content

Commit 5dc823c

Browse files
MalvozLeoColomb
authored andcommitted
Content Transformation: Update link to RFC, add mentions of Lite Mode (#191)
* Update link to RFC, add mentions of Lite Mode Changes motivated by #185 * Refactor desc., highlight caution for disabling I added that we're using `cache-control: no-transform` in the introductory paragraph because that is what we link to below that paragraph. Can remove if redundant, but added for clarity. Also, IMO we should still separate the warnings "(!)" about considering the impact of disabling content transformations and "If you are using `mod_pagespeed`" because the majority of developers probably aren't using `mod_pagespeed` and so if you aren't using it, it's simple to distinguish.
1 parent 7470165 commit 5dc823c

File tree

1 file changed

+19
-10
lines changed

1 file changed

+19
-10
lines changed

src/web_performance/content_transformation.conf

+19-10
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,29 @@
22
# | Content transformation |
33
# ----------------------------------------------------------------------
44

5-
# Prevent intermediate caches or proxies (e.g.: such as the ones
6-
# used by mobile network providers) from modifying the website's
7-
# content.
5+
# Prevent intermediate caches or proxies (such as those used by mobile
6+
# network providers) and browsers data-saving features from modifying
7+
# the website's content using the `cache-control: no-transform` directive.
88
#
99
# https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cache-Control
10-
# https://tools.ietf.org/html/rfc2616#section-14.9.5
10+
# https://tools.ietf.org/html/rfc7234#section-5.2.2.4
1111
#
12-
# (!) If you are using `mod_pagespeed`, please note that setting
13-
# the `Cache-Control: no-transform` response header will prevent
14-
# `PageSpeed` from rewriting `HTML` files, and, if the
15-
# `ModPagespeedDisableRewriteOnNoTransform` directive isn't set
16-
# to `off`, also from rewriting other resources.
12+
# (!) Carefully consider the impact on your visitors before disabling
13+
# content transformation. These transformations are performed to
14+
# improve the experience for data- and cost-constrained users
15+
# (e.g. users on a 2G connection).
1716
#
18-
# https://developers.google.com/speed/pagespeed/module/configuration#notransform
17+
# You can test the effects of content transformation applied by
18+
# Google's Lite Mode by visiting: https://googleweblight.com/i?u=https://www.example.com
19+
#
20+
# https://support.google.com/webmasters/answer/6211428
21+
#
22+
# (!) If you are using `mod_pagespeed`, note that disabling this will
23+
# prevent `PageSpeed` from rewriting HTML files, and, if the
24+
# `ModPagespeedDisableRewriteOnNoTransform` directive isn't set to
25+
# `off`, also from rewriting other resources.
26+
#
27+
# https://developers.google.com/speed/pagespeed/module/configuration#notransform
1928

2029
<IfModule mod_headers.c>
2130
Header merge Cache-Control "no-transform"

0 commit comments

Comments
 (0)