diff --git a/content/discoverable/write-descriptive-text/index.md b/content/discoverable/write-descriptive-text/index.md index d3068fea0fb..44d79033673 100644 --- a/content/discoverable/write-descriptive-text/index.md +++ b/content/discoverable/write-descriptive-text/index.md @@ -24,40 +24,47 @@ Lighthouse displays failed audits, like the ones below, if your content is diffi search engines to understand: - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + +
Failed auditHow to fix it
Document does not have a meta descriptionAdd tags to the head of the -page
Document does not have a title element
Links don't have descriptive textAdd descriptive link text
Failed auditHow to fix it
Document does not have a meta description + Add tags to the head of the page +
Document does not have a title element + Add tags to the head of the page +
Links don't have descriptive text + Add descriptive link text +
## Add tags to the head of the page Add a meta description and title for every page on your site. Here's a full -example of what the < head > of each page should include: +example of what the `````` of each page should include: ``` Mary's Maple Bar Fast-Baking Recipe - + @@ -67,65 +74,39 @@ example of what the < head > of each page should include: -

Hi there!

-

- I'm your cool new webpage. Made with Glitch! -

- -
- + ... ``` Here are some examples of good vs bad titles and descriptions: - - - - - - - - - - - - - - - - - -
GoodBad

-Mary's Maple Bar Fast-Baking Recipe
-

- -

-Donut recipe
-

- -

-
-

- -

-
-

- -
+

Not recommended — too vague

+
+<title>Donut recipe</title>
+<meta name="description" content="A donut recipe.">
+
+ +

Recommended — precise!

+
+<title>Mary's Maple Bar Fast-Baking Recipe</title>
+<meta
+  name="description"
+  content="Mary's maple bar recipe is simple and sweet,
+           with just a touch of serendipity. Topped with
+           bacon, this sticky donut is to die for.">
+
Here are some best practices to keep in mind when you're writing descriptions and titles: -+ Make them **descriptive and concise.** Avoid vague titles like "Home" and ++ Make them descriptive and concise. Avoid vague titles like "Home" and link text like "click here". -+ Avoid [**keyword - stuffing**](https://support.google.com/webmasters/answer/66358). Cramming ++ Avoid [keyword + stuffing](https://support.google.com/webmasters/answer/66358). Cramming your content with keywords isn't helpful to users, and search engines may mark the page as spam. -+ **Avoid repeated or boilerplate titles and descriptions** for each page. If you ++ Avoid repeated or boilerplate titles and descriptions for each page. If you have a big site, use the [HTML Improvements Report](https://support.google.com/webmasters/answer/80407) to crawl the site and discover any page that's missing a title. @@ -143,28 +124,25 @@ specific descriptions. You'll need to read the context of the page and write relevant text that makes sense with the rest of the content. Here's an example of good vs bad link descriptions: - - - - - - - - - - - - - -
GoodBad

-

Get cooking and learn how to make a delicious maple bar with Mary!

-

- -

-

Get cooking and learn how to make a maple bar here

. -

- -
+

Not recommended — too vague

+
+<p>
+  Get cooking and learn how to make a maple bar
+  <a href="https://donut-be-crazy.com/recipes/maple-bar-recipe">
+    here
+  </a>.
+</p>
+
+ +

Recommended — precise!

+
+<p>
+  Get cooking and learn how to
+  <a href="https://donut-be-crazy.com/recipes/maple-bar-recipe">
+    make a delicious maple bar with Mary
+  </a>!
+</p>
+
Here are some best practices to keep in mind when you're writing descriptive link text: @@ -173,12 +151,12 @@ link text: + Don't use the page's URL as the link description, unless you have a good reason to do so, such as referencing a site's new address. + Keep descriptions concise. Aim for a few words or a short phrase. -+ Format links so that they're easy to spot. ++ Format links so that users can easily spot them. + Pay attention to your internal links, too. Improving the quality of internal links can help users and search engines navigate your site. See -[Use links wisely](https://support.google.com/webmasters/answer/7451184#optimize) +[Use links wisely](https://support.google.com/webmasters/answer/7451184#uselinkswisely) for more tips. ## Verify @@ -189,3 +167,4 @@ results of the following audits: + Document does not have a meta description + Document does not have a title element + Links don't have descriptive text +If you fixed the issue(s), the audits display in the "passed audits" section of the report.