-
Notifications
You must be signed in to change notification settings - Fork 237
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
base: main
Are you sure you want to change the base?
Improve title format for better SEO and readability #1056
Conversation
@kaishin @alexandersandberg Please review this PR, as I believe it will be beneficial when the website is shared or searched for. |
@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: Re: the homepage title, I wonder if there's value to still including Swift.org in the title. Perhaps |
@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. 😉 |
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. |
@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. |
There was a problem hiding this 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.)
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 formatSwift.org - Page Title
, placing the main topic last, which is suboptimal for search engine visibility and user experience.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 likeWelcome 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.