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 2 commits 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. 😉

@alemohamad
Copy link
Contributor Author

Hi there, team! I’m sending this message to check if it gains visibility for this proposal.

@davelester Let me know if you know how to start a conversation with the team.

@davelester
Copy link
Contributor

@alemohamad We discussed this PR during yesterday's Swift website workgroup meeting in the larger context of SEO improvements to swift.org; sharing my review now.

@davelester davelester added the SEO Issues related to search engine optimization (SEO). label Jul 2, 2025
@alemohamad alemohamad requested a review from tkremenek as a code owner July 2, 2025 18:14
@alemohamad alemohamad requested a review from davelester July 2, 2025 18:15
Copy link
Member

@alexandersandberg alexandersandberg left a comment

Choose a reason for hiding this comment

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

Personally I think this looks great and is a big improvement, thank you!

(Waiting with approving to give others a chance to review.)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
SEO Issues related to search engine optimization (SEO).
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants