Skip to content

Improve title format for better SEO and readability #1056

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 1 commit into
base: main
Choose a base branch
from

Conversation

alemohamad
Copy link
Contributor

Motivation:

The homepage currently shows Swift.org - Welcome to Swift.org as the <title>, which is redundant and not ideal for SEO. Internal pages use the format Swift.org - Page Title, placing the main topic last, which is suboptimal for search engine visibility and user experience.

swift-org-seo

Additionally, using multiple hyphens in titles such as Swift.org - Install Swift - macOS can make it harder to visually parse where the subject ends and the site name begins. Replacing the separator with an em dash () improves clarity by visually distinguishing the content title from the site name.

Result:

This PR proposes changing the homepage title to Swift Programming Language, as it offers a more descriptive label for search engines and link previews. However, this is open to discussion — alternatives like Welcome to Swift.org may also be appropriate, depending on how the community prefers to present the project. Personally, I believe the proposed title better highlights the language itself and improves discoverability, but it's not intended as a final decision.

Internal page titles now place the page subject first, followed by the site name separated by an em dash, improving structure, clarity, and SEO performance.

swift-org-new-titles

@alemohamad
Copy link
Contributor Author

@kaishin @alexandersandberg Please review this PR, as I believe it will be beneficial when the website is shared or searched for.

@davelester
Copy link
Contributor

@alemohamad Thanks for this contribution! Some thoughts below:

Re: internal pages, I agree that it'd be great to remove multiple hyphens from page titles. What if we used a vertical bar instead of the em dash for greater visual separation? For example: Install Swift - macOS | Swift.org.

Re: the homepage title, I wonder if there's value to still including Swift.org in the title. Perhaps Swift Programming Language | Swift.org? I'm curious about what others in the Swift.org website workgroup think.

@alemohamad
Copy link
Contributor Author

alemohamad commented Jun 10, 2025

@davelester Thanks for your feedback. Yes, I also considered using a pipe (|) as a separator, but I thought another symbol to avoid confusion with the letter “I.” Regardless, it serves as a separator. In my opinion, we shouldn’t have Swift.org at the homepage title, but if the team believes it adds value, I can agree. The primary objective was to avoid repeating Swift.org on the homepage. 😉

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants