Skip to content

SEO Tasks: Improve SEO Titles & Meta Descriptions #473

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions _case_studies/doximity.html
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: default
title: Doximity Case Study - Fast, Flexible, and Scalable
description: Read how Rails has helped Doximity grow into the largest digital platform for U.S. medical professionals.
title: "Doximity Case Study — Ruby on Rails"
description: "Read how Rails has helped Doximity grow into the largest digital platform for U.S. medical professionals."
og_image: assets/images/case-study-doximity.png
permalink: /docs/case-studies/doximity
redirect_from:
Expand Down
4 changes: 2 additions & 2 deletions _config.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
title: Ruby on Rails
description: A web-app framework that includes everything needed to create database-backed web applications according to the Model-View-Controller (MVC) pattern.
title: "Ruby on Rails: Compress the complexity of modern web apps"
description: "A full-stack web application framework written in Ruby, following the Model View Controller pattern, that includes everything you need to build modern database-backed web apps."
twitter: rails
feed_path: /feed.xml
world23_title: Rails World - 2023
Expand Down
2 changes: 1 addition & 1 deletion _includes/head.html
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@
{% assign url = page.url | absolute_url %}

<head>
<title>{{ site.title }} &mdash; {% if page.title %}{{ page.title }}{% else %}{{ site.description }}{% endif %}</title>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Title length should ideally be around 55-60 characters. Anything else might not be seen. 70 is considered the upper limit. How long are the site descriptions? I'd also put the page title before the Site title:

"Doximity Case Study — Ruby on Rails" as opposed to "Ruby on Rails — Doximity Case Study"

Again with truncation in search results, we want to ensure that the important detail is up front.

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I checked all the titles and shorten 2 of them to be <70. The descriptions are around 150 to 160 chars (a couple of them bit longer at over 200). The ones Ranker suggested in the doc are much longer, I reworded/shorten most of them (and awaiting tweaks from @AmandaPerino)

In terms of that specific line, yeah I'm removing the site.title - page.title thing, and only defaulting to site.title for pages where a page title is not found at all.

<title>"{{ title }}"</title>
<meta charset="utf-8" />
<meta content="ie=edge" http-equiv="x-ua-compatible" />
<meta name="handheldfriendly" content="true" />
Expand Down
4 changes: 2 additions & 2 deletions _pages/community.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Community
description:
title: "Ruby on Rails Community"
description: "Rails improves every year thanks to hundreds of contributors. Meet the Core, Committers, and Issues team and learn how you can also make Rails better."
permalink: /community
redirect_from:
- /community/
Expand Down
4 changes: 2 additions & 2 deletions _pages/conduct.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Code of Conduct
description:
title: "Code of Conduct: Our Pledge, Standards & Scope"
description: "Rails is committed to fostering a welcoming community. If you encounter any unacceptable behavior, follow these steps to report the issue."
permalink: /conduct
redirect_from:
- /conduct/
Expand Down
4 changes: 2 additions & 2 deletions _pages/docs.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Docs
description:
title: "Ruby on Rails Documentation"
description: "The official Rails documentation: installation, getting started, in-depth guides, and API reference."
permalink: /docs
redirect_from:
- /docs/
Expand Down
4 changes: 2 additions & 2 deletions _pages/foundation.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: The Rails Foundation
description:
title: "The Rails Foundation"
description: "Learn about the Rails Foundation's mission, current work, members, board, executive director, structure, and budget."
category: foundation
permalink: /foundation
redirect_from:
Expand Down
4 changes: 2 additions & 2 deletions _pages/maintenance.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Maintenance policy
description:
title: "Ruby on Rails Maintenance Policy"
description: "Learn about Rails' official maintenance policy: how features, fixes and security issues are prioritized and supported."
permalink: /maintenance
redirect_from:
- /maintenance/
Expand Down
4 changes: 2 additions & 2 deletions _pages/privacy.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Privacy
description:
title: "The Rails Foundation Privacy Policy"
description: "The Rails Foundation wants to make sure that your data is secure and private. Learn how we collect and use your information."
permalink: /foundation/privacy
redirect_from:
- /privacy/
Expand Down
4 changes: 2 additions & 2 deletions _pages/security.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Security
description:
title: "Security Policy: Rails takes web security very seriously"
description: "Rails includes features to protect web apps from common issues like CSRF, Script Injection, SQL Injection, and the like."
permalink: /security
redirect_from:
- /security/
Expand Down
4 changes: 2 additions & 2 deletions _pages/trademarks.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Trademarks policy
description:
title: "Ruby on Rails Trademark policy"
description: "Learn how to properly use the Ruby on Rails name and logo. This page explains the official trademark policy, permissions, and usage guidelines."
permalink: /trademarks
redirect_from:
- /trademarks/
Expand Down
4 changes: 2 additions & 2 deletions blog/index.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: News
description:
title: "Latest Rails News & Release Notes"
description: "Discover the latest Ruby on Rails news, Rails foundation updates, new version and feature announcements. All in one place."
---

<div class="heading common-padding--bottom-small common-padding--top-small">
Expand Down
4 changes: 2 additions & 2 deletions category/foundation.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Foundation
description:
title: "The Rails Foundation News"
description: "Announcements from the Rails Foundation about the Rails World conference, new members, and other initiatives to grow the Rails ecosystem."
category: foundation
permalink: /category/foundation
redirect_from:
Expand Down
4 changes: 2 additions & 2 deletions category/news.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: News
description:
title: "This Week in Rails: highlight updates to the Rails codebase"
description: "Weekly updates from the Rails core/issues team on changes merged to the Rails codebase that week."
category: news
permalink: /category/news
redirect_from:
Expand Down
4 changes: 2 additions & 2 deletions category/releases.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Releases
description:
title: "Ruby on Rails new release updates"
description: "Keep up to date with new versions, latest features, bug fixes, and important security updates from the core team."
category: releases
permalink: /category/releases
redirect_from:
Expand Down
3 changes: 2 additions & 1 deletion doctrine/index.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: The Rails Doctrine
title: "The Ruby on Rails Doctrine"
description: "Read about Rails design pillars like convention over configuration, optimize for programmer happiness, value integrated systems, the menu is omakase, push up a bit tent, and more."
permalink: /doctrine
redirect_from:
- /doctrine/
Expand Down
2 changes: 2 additions & 0 deletions index.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
---
id: home
title: "Ruby on Rails: Compress the complexity of modern web apps"
description: "A full-stack web application framework written in Ruby, following the Model View Controller pattern, that includes everything you need to build modern database-backed web apps."
---

<div class="heading common-padding--bottom common-padding--top-small">
Expand Down
2 changes: 2 additions & 0 deletions world/2025/index.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
---
title: "Rails World 2025 - Sept 4 & 5 in Amsterdam"
description: "Rails World 2025 is back in Amsterdam! Join us on Sept 4 & 5"
layout: world/2025/default
permalink: /world/2025
redirect_from: /world/2025/
Expand Down
4 changes: 2 additions & 2 deletions world/index.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Rails World
description: Rails World is an annual two-day, two track Rails community conference
title: "Rails World Conference"
description: Rails World is an annual two day Rails community conference, with location across Europe and North America, featuring technical talks, workshops, and keynotes about best practices in Rails development.
permalink:
---

Expand Down