Skip to content

Commit 675f79b

Browse files
authored
Redundancy-free internal links (GoogleChrome#5104)
* Remove redundant https://web.dev prefixes in links * Fix two files
1 parent c08db5d commit 675f79b

File tree

102 files changed

+578
-578
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

102 files changed

+578
-578
lines changed

CONTRIBUTING.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,18 @@ proposal.
1212

1313
### Contributor License Agreements
1414

15-
We'd love to accept your code patches! However, before we can take them, we
15+
We'd love to accept your code patches! However, before we can take them, we
1616
have to jump a couple of legal hurdles.
1717

18-
Please fill out either the individual or corporate Contributor License
18+
Please fill out either the individual or corporate Contributor License
1919
Agreement.
2020

21-
* If you are an individual writing original source code and you're sure you
21+
* If you are an individual writing original source code and you're sure you
2222
own the intellectual property, then sign an [individual CLA](https://developers.google.com/open-source/cla/individual).
23-
* If you work for a company that wants to allow you to contribute your work,
23+
* If you work for a company that wants to allow you to contribute your work,
2424
then sign a [corporate CLA](https://developers.google.com/open-source/cla/corporate).
2525

26-
Follow either of the two links above to access the appropriate CLA and
26+
Follow either of the two links above to access the appropriate CLA and
2727
instructions for how to sign and return it.
2828

2929
1. Sign the contributors license agreement above.
@@ -39,7 +39,7 @@ the CLA.
3939

4040
## Writing Code
4141

42-
If your contribution contains code, please make sure that it follows
42+
If your contribution contains code, please make sure that it follows
4343
[the style guide](https://google.github.io/styleguide/jsguide.html).
4444
Otherwise, we will have to ask you to make changes, and that's no fun for anyone.
4545

src/site/content/en/blog/a11y-tips-for-web-dev/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -464,7 +464,7 @@ debugging the accessibility of your visual components.
464464
Tenon has strong integration support across build tools, browsers (via extensions), and even text editors.
465465
- There are many library- and framework-specific tools
466466
for highlighting accessibility issues with components.
467-
For example, [web.dev](https://web.dev/accessibility-auditing-react/)
467+
For example, [web.dev](/accessibility-auditing-react/)
468468
explains how to use [eslint-plugin-jsx-a11y](https://www.npmjs.com/package/eslint-plugin-jsx-a11y)
469469
to highlight accessibility issues for React components in your editor:
470470

src/site/content/en/blog/agrofy/index.md

+15-15
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,10 @@ America's agribusiness market. They match up buyers and sellers of farm
2020
machines, land, equipment, and financial services. In Q3 2020 a 4-person
2121
development team at Agrofy spent a month optimizing their website because they
2222
hypothesized that improved performance would lead to reduced bounce rates. They
23-
specifically focused on improving [LCP](https://web.dev/lcp/), which is one of
24-
the [Core Web Vitals](https://web.dev/vitals/#core-web-vitals). These
23+
specifically focused on improving [LCP](/lcp/), which is one of
24+
the [Core Web Vitals](/vitals/#core-web-vitals). These
2525
performance optimizations led to a 70% improvement in LCP, which correlated to a
26-
76% reduction in load abandonment (from 3.8% to 0.9%).
26+
76% reduction in load abandonment (from 3.8% to 0.9%).
2727

2828
<div class="w-stats">
2929
<div class="w-stat">
@@ -38,8 +38,8 @@ performance optimizations led to a 70% improvement in LCP, which correlated to a
3838

3939
## Problem
4040

41-
While studying their business metrics, a development team at Agrofy noticed
42-
that their bounce rates seemed higher than industry benchmarks. Technical
41+
While studying their business metrics, a development team at Agrofy noticed
42+
that their bounce rates seemed higher than industry benchmarks. Technical
4343
debt was also increasing in the website codebase.
4444

4545
## Solution
@@ -52,30 +52,30 @@ The Agrofy team pitched their executives and got buy-in to:
5252

5353
The migration took 2 months. Aside from the 4-person development team mentioned
5454
earlier, this migration also involved product and UX specialists and a software
55-
architect.
55+
architect.
5656
The optimization project took the 4-person development team 1 month. They
57-
focused on LCP, [CLS](https://web.dev/cls/) (another Core Web Vitals metric),
58-
and [FCP](https://web.dev/fcp/). Specific optimizations included:
57+
focused on LCP, [CLS](/cls/) (another Core Web Vitals metric),
58+
and [FCP](/fcp/). Specific optimizations included:
5959

6060
+ Lazy loading all non-visible elements with the
6161
[Intersection Observer API](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API).
6262
+ Delivering static resources faster with a [content delivery
63-
network](https://web.dev/content-delivery-networks/).
64-
+ [Lazy loading images](https://web.dev/browser-level-image-lazy-loading/)
63+
network](/content-delivery-networks/).
64+
+ [Lazy loading images](/browser-level-image-lazy-loading/)
6565
with `loading="lazy"`.
6666
+ [Server-side rendering](https://developers.google.com/web/updates/2019/02/rendering-on-the-web)
6767
of
6868
[critical rendering path](https://developers.google.com/web/fundamentals/performance/critical-rendering-path)
6969
content.
70-
+ [Preloading and preconnecting](https://web.dev/fast/#optimize-your-resource-delivery)
70+
+ [Preloading and preconnecting](/fast/#optimize-your-resource-delivery)
7171
critical resources to minimize handshake times.
7272
+ Using real user monitoring (RUM) tools to identify which product detail
7373
pages were experiencing lots of layout shifts and then make adjustments to
7474
the codebase's architecture.
7575

7676
Check out the
7777
[Agrofy engineering blog post](https://mollar-luciano.medium.com/how-agrofy-optimised-core-web-vitals-and-improved-business-metrics-2f73311bca)
78-
for more technical details.
78+
for more technical details.
7979

8080
After enabling the new codebase on 20% of traffic, they launched the new site to
8181
all visitors in early September 2020.
@@ -88,11 +88,11 @@ different metrics:
8888
+ LCP improved 70%.
8989
+ CLS improved 72%.
9090
+ Blocking JS requests reduced 100% and blocking CSS requests 80%.
91-
+ [Long tasks](https://web.dev/long-tasks-devtools/) reduced 72%.
92-
+ [First CPU Idle](https://web.dev/first-cpu-idle/) improved 25%.
91+
+ [Long tasks](/long-tasks-devtools/) reduced 72%.
92+
+ [First CPU Idle](/first-cpu-idle/) improved 25%.
9393

9494
Over the same time frame, real user monitoring data (also known as [field
95-
data](https://web.dev/how-to-measure-speed/#lab-data-vs-field-data)) showed that
95+
data](/how-to-measure-speed/#lab-data-vs-field-data)) showed that
9696
the load abandonment rate on product detail pages dropped 76%, from 3.8% to
9797
0.9%:
9898

src/site/content/en/blog/app-shortcuts/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,7 @@ Check out the [app shortcuts sample] and its [source].
238238
* Blink Component: [`UI>Browser>WebAppInstalls`]
239239

240240
[Progressive Web Apps]: /progressive-web-apps/
241-
[What does it take to be installable?]: https://web.dev/install-criteria/
241+
[What does it take to be installable?]: /install-criteria/
242242
[scope]: /add-manifest/#scope
243243
[web app manifest]: /add-manifest
244244
[web app manifest icons]: /add-manifest/#icons

src/site/content/en/blog/ar-hit-test/index.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -33,9 +33,9 @@ In this article I assume you already know how to create an augmented reality
3333
session and that you know how to run a frame loop. If you're not familiar with
3434
these concepts, you should read the earlier articles in this series.
3535

36-
* [Virtual reality comes to the web](https://web.dev/vr-comes-to-the-web/)
37-
* [Virtual reality comes to the web, part II](https://web.dev/vr-comes-to-the-web-pt-ii/)
38-
* [Web AR: you may already know how to use it](https://web.dev/web-ar)
36+
* [Virtual reality comes to the web](/vr-comes-to-the-web/)
37+
* [Virtual reality comes to the web, part II](/vr-comes-to-the-web-pt-ii/)
38+
* [Web AR: you may already know how to use it](/web-ar)
3939

4040
## The immersive AR session sample
4141

src/site/content/en/blog/aspect-ratio/index.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ tags:
1616
{% Aside %}
1717

1818
Summary: Maintaining a consistent width-to-height ratio, called an *aspect ratio*, is critical in
19-
responsive web design and for preventing [cumulative layout shift](https://web.dev/cls/). Now,
19+
responsive web design and for preventing [cumulative layout shift](/cls/). Now,
2020
there's a more straightforward way to do this with the new `aspect-ratio` property launching in
2121
[Chromium 88](https://www.chromestatus.com/feature/5738050678161408), [Firefox
2222
87](https://developer.mozilla.org/en-US/docs/Mozilla/Firefox/Experimental_features#property_aspect-ratio), and [Safari Technology Preview
@@ -241,7 +241,7 @@ img {
241241

242242
### Bonus tip: image attributes for aspect ratio
243243

244-
Another way to set an image's aspect ratio is through [image attributes](https://www.smashingmagazine.com/2020/03/setting-height-width-images-important-again/). If you know the dimensions of the image ahead of time, it is a [best practice](https://web.dev/image-aspect-ratio/#check-the-image's-width-and-height-attributes-in-the-html) to
244+
Another way to set an image's aspect ratio is through [image attributes](https://www.smashingmagazine.com/2020/03/setting-height-width-images-important-again/). If you know the dimensions of the image ahead of time, it is a [best practice](/image-aspect-ratio/#check-the-image's-width-and-height-attributes-in-the-html) to
245245
set these dimensions as its `width` and `height`.
246246

247247
For our example above, knowing the dimensions are 800px by 600px, the image markup would look like: `<img src="image.jpg"

src/site/content/en/blog/async-clipboard/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -402,7 +402,7 @@ simplified events aligned with the
402402
[Drag and Drop API](https://developer.mozilla.org/en-US/docs/Web/API/HTML_Drag_and_Drop_API).
403403
Because of potential risks Chrome is
404404
treading carefully. To stay up to date on Chrome's progress, watch this article
405-
and our [blog](https://web.dev/blog/) for updates.
405+
and our [blog](/blog/) for updates.
406406

407407
For now, support for the Clipboard API is available in
408408
[a number of browsers](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard#Browser_compatibility).

src/site/content/en/blog/at-property/index.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -129,8 +129,8 @@ each gradient declaration is parsed as a string.
129129
<figure class="w-figure">
130130
<img class="w-screenshot" src="https://storage.googleapis.com/web-dev-assets/at-property/support1.gif">
131131
<figcaption class="w-figcaption">
132-
Using a custom property with a "number" syntax, the gradient on the left shows a smooth
133-
transition between stop values. The gradient on the right uses a default custom property
132+
Using a custom property with a "number" syntax, the gradient on the left shows a smooth
133+
transition between stop values. The gradient on the right uses a default custom property
134134
(no syntax defined) and shows an abrupt transition.
135135
</figcaption>
136136
</figure>
@@ -140,8 +140,8 @@ each gradient declaration is parsed as a string.
140140
<source src="https://storage.googleapis.com/web-dev-assets/at-property/support1.mp4" type="video/mp4">
141141
</video>
142142
<figcaption class="w-figcaption">
143-
Using a custom property with a "number" syntax, the gradient on the left shows a smooth
144-
transition between stop values. The gradient on the right uses a default custom property
143+
Using a custom property with a "number" syntax, the gradient on the left shows a smooth
144+
transition between stop values. The gradient on the right uses a default custom property
145145
(no syntax defined) and shows an abrupt transition.
146146
</figcaption>
147147
</figure>
@@ -231,7 +231,7 @@ you could write something like:
231231
}
232232
```
233233

234-
## Conclusion
234+
## Conclusion
235235

236236
The `@property` rule makes an exciting technology even more accessible by
237237
allowing you to write semantically meaningful CSS within CSS itself. To learn
@@ -240,7 +240,7 @@ resources:
240240

241241
- [Is Houdini Ready Yet?](http://ishoudinireadyyet.com/)
242242
- [MDN Houdini Reference](https://developer.mozilla.org/en-US/docs/Web/Houdini)
243-
- [Smarter custom properties with Houdini's new API](https://web.dev/css-props-and-vals/)
243+
- [Smarter custom properties with Houdini's new API](/css-props-and-vals/)
244244
- [Houdini CSSWG Issue Queue](https://github.com/w3c/css-houdini-drafts/issues)
245245

246246
Photo by [Cristian Escobar](https://unsplash.com/@cristian1) on Unsplash.

src/site/content/en/blog/autowebperf/index.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -23,14 +23,14 @@ tags:
2323
[AutoWebPerf](https://github.com/GoogleChromeLabs/AutoWebPerf) (AWP) is a
2424
modular tool that enables automatic gathering of performance data from multiple
2525
sources. Currently there are [many tools
26-
available](https://web.dev/vitals-tools/) to measure website performance for
26+
available](/vitals-tools/) to measure website performance for
2727
different scopes ([lab and
28-
field](https://web.dev/how-to-measure-speed/#lab-data-vs-field-data)), such as
28+
field](/how-to-measure-speed/#lab-data-vs-field-data)), such as
2929
Chrome UX Report, PageSpeed Insights, or WebPageTest. AWP offers integration
3030
with various audit tools with a simple setup so you can continuously monitor the
3131
site performance in one place.
3232

33-
The release of [Web Vitals](https://web.dev/vitals/) guidance means that close
33+
The release of [Web Vitals](/vitals/) guidance means that close
3434
and active monitoring of web pages is becoming increasingly important. The
3535
engineers behind this tool have been doing performance audits for years and they
3636
created AWP to automate a manual, recurring, and time consuming part of their
@@ -47,14 +47,14 @@ Although several tools and APIs are available to monitor the performance of web
4747
pages, most of them expose data measured at a specific time. To adequately
4848
monitor a website and maintain good performance of key pages, it's recommended
4949
to continuously take measurements of [Core Web
50-
Vitals](https://web.dev/vitals/#core-web-vitals) over time and observe trends.
50+
Vitals](/vitals/#core-web-vitals) over time and observe trends.
5151

5252
AWP makes that easier by providing an engine and pre-built API integrations
5353
which can be programmatically configured to automate recurrent queries to
5454
various performance monitoring APIs.
5555

5656
For example, with AWP, you can set a daily test on your home page to capture the
57-
field data from [CrUX API](https://web.dev/chrome-ux-report-api/) and lab data
57+
field data from [CrUX API](/chrome-ux-report-api/) and lab data
5858
from a
5959
[Lighthouse report from PageSpeed Insights](https://developers.google.com/speed/pagespeed/insights/).
6060
This data can be written and stored over time, for example, in [Google
@@ -82,8 +82,8 @@ Google Sheets).
8282
AWP comes with a number of pre-implemented gatherers and connectors:
8383

8484
* Pre-implemented gatherers:
85-
* [CrUX API](https://web.dev/chrome-ux-report-api/)
86-
* [CrUX BigQuery](https://web.dev/chrome-ux-report-bigquery/)
85+
* [CrUX API](/chrome-ux-report-api/)
86+
* [CrUX BigQuery](/chrome-ux-report-bigquery/)
8787
* [PageSpeed Insights API](https://developers.google.com/speed/docs/insights/v5/get-started)
8888
* [WebPageTest API](https://www.webpagetest.org/getkey.php)
8989
* Pre-implemented connectors:

src/site/content/en/blog/betty-crocker/index.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Betty Crocker asked themselves how they could port the killer feature of their i
6161
over to the web app.
6262
This is when they learned about
6363
[Project Fugu](https://developers.google.com/web/updates/capabilities) and the
64-
[Wake Lock API](https://web.dev/wakelock/).
64+
[Wake Lock API](/wakelock/).
6565

6666
{% Img src="image/admin/Yoj65m20XpoPdaL8ejAv.jpg", alt="A person kneading dough on a kitchen table covered in flour", width="800", height="533" %}
6767

@@ -346,7 +346,7 @@ Other examples are boarding pass or ticket apps that need to keep the screen on
346346
until the barcode has been scanned, kiosk-style apps that keep the screen on continuously,
347347
or web-based presentation apps that prevent the screen from sleeping during a presentation.
348348

349-
We have compiled [everything you need to know about the Wake Lock API](https://web.dev/wakelock/)
349+
We have compiled [everything you need to know about the Wake Lock API](/wakelock/)
350350
in a comprehensive article on this very site.
351351
Happy reading, and happy cooking!
352352

src/site/content/en/blog/bfcache/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ loads:
5555
<td>
5656
A new request is initiated to load the previous page, and, depending
5757
on how well that page has been <a
58-
href="https://web.dev/reliable/#the-options-in-your-caching-toolbox">
58+
href="/reliable/#the-options-in-your-caching-toolbox">
5959
optimized</a> for repeat visits, the browser might have to re-download,
6060
re-parse, and re-execute some (or all) of resources it just downloaded.
6161
</td>

src/site/content/en/blog/browser-fs-access/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -251,7 +251,7 @@ the demo cannot be embedded in this article.
251251
## The browser-fs-access library in the wild
252252

253253
In my free time, I contribute a tiny bit to an
254-
[installable PWA](https://web.dev/progressive-web-apps/#installable)
254+
[installable PWA](/progressive-web-apps/#installable)
255255
called [Excalidraw](https://excalidraw.com/),
256256
a whiteboard tool that lets you easily sketch diagrams with a hand-drawn feel.
257257
It is fully responsive and works well on a range of devices from small mobile phones to computers with large screens.

src/site/content/en/blog/building-a-pwa-at-google-part-1/index.md

+6-6
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,9 @@ means a complete overview of PWAs. The aim is to share learnings from our team's
2929
For this first post we'll cover a little background information first and then dive into all the
3030
stuff we learned about service workers.
3131

32-
{% Aside %}
32+
{% Aside %}
3333
Bulletin was shut down in 2019 due to lack of product/market fit. We still learned a lot about PWAs
34-
along the way!
34+
along the way!
3535
{% endAside %}
3636

3737
## Background {: #background }
@@ -44,7 +44,7 @@ Before we delve into the development process, let's examine why building a PWA w
4444
option for this project:
4545

4646
* **Ability to iterate quickly**. Especially valuable since Bulletin would be piloted in
47-
multiple markets.
47+
multiple markets.
4848
* **Single code base**. Our users were roughly evenly split between Android and iOS. A PWA meant
4949
we could build a single web app that would work on both platforms. This increased the velocity
5050
and impact of the team.
@@ -66,7 +66,7 @@ You can't have a PWA without a [service
6666
worker](https://developers.google.com/web/fundamentals/primers/service-workers/). Service workers
6767
give you a lot of power, such as advanced caching strategies, offline capabilities, background sync,
6868
etc. While service workers do add some complexity, we found that their benefits outweighed the added
69-
complexity.
69+
complexity.
7070

7171
### Generate it if you can {: #generate }
7272

@@ -142,13 +142,13 @@ disable the memory cache. In order to cover more browsers, we opted for a differ
142142
including a flag to disable caching in our service worker which is enabled by default on developer
143143
builds. This ensures that devs always get their most recent changes without any caching issues. It's
144144
important to include the `Cache-Control: no-cache` header as well to [prevent the browser from
145-
caching any assets](https://web.dev/http-cache/#unversioned-urls).
145+
caching any assets](/http-cache/#unversioned-urls).
146146

147147
### Lighthouse {: #lighthouse }
148148

149149
[Lighthouse](https://developers.google.com/web/tools/lighthouse/) provides a number of debugging
150150
tools useful for PWAs. It scans a site and generates reports covering PWAs, performance,
151-
accessibility, SEO, and other best practices.
151+
accessibility, SEO, and other best practices.
152152
We recommend [running Lighthouse on continuous
153153
integration](https://github.com/GoogleChrome/lighthouse-ci) to alert you if you break one of the
154154
criteria to be a PWA. This actually happened to us once, where the service worker wasn't installing

src/site/content/en/blog/building-a-settings-component/index.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -194,8 +194,8 @@ want a large gap, but not as large as if we're on a wide screen.
194194

195195
The `grid-template-columns` property uses 3 CSS functions: `repeat()`, `minmax()` and
196196
`min()`. [Una Kravets](#) has a [great layout blog
197-
post](https://web.dev/one-line-layouts/) about this, calling it
198-
[RAM](https://web.dev/one-line-layouts/#07.-ram-(repeat-auto-minmax):-grid-template-columns(auto-fit-minmax(lessbasegreater-1fr))).
197+
post](/one-line-layouts/) about this, calling it
198+
[RAM](/one-line-layouts/#07.-ram-(repeat-auto-minmax):-grid-template-columns(auto-fit-minmax(lessbasegreater-1fr))).
199199

200200
There's 3 special additions in our layout, if you compare it to Una's:
201201

@@ -433,8 +433,8 @@ a better location:
433433
```
434434

435435
Learn all about it in this [`color-scheme`
436-
article](https://web.dev/color-scheme/) by [Thomas
437-
Steiner](https://web.dev/authors/thomassteiner/). There's a lot more to gain
436+
article](/color-scheme/) by [Thomas
437+
Steiner](/authors/thomassteiner/). There's a lot more to gain
438438
than dark checkbox inputs!
439439

440440
### CSS `accent-color`
@@ -677,7 +677,7 @@ is a Level 5 spec addition that
677677

678678
The goal was an easy to manage and animated visual highlight for user feedback.
679679
By using a box shadow I can avoid [triggering
680-
layout](https://web.dev/animations-guide/#triggers) with the effect. I do this
680+
layout](/animations-guide/#triggers) with the effect. I do this
681681
by creating a shadow that's not blurred and matches the circular shape of the
682682
thumb element. Then I change and transition it's spread size on hover.
683683

0 commit comments

Comments
 (0)