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
Update the titles of the techniques page #550
Conversation
✅ Deploy Preview for i18n-drafts ready!
To edit notification comments on pull requests, go to your Netlify site configuration. |
LGTM as long as it's always clear from the link or the styling that this is the title of a document. |
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.
See comment about titlecase
article-list/articlelist.en.html
Outdated
@@ -51,7 +51,7 @@ | |||
<div class="content"> | |||
<h1>Articles & tutorials</h1> | |||
|
|||
<p>You can also find resources using the page <a href="https://www.w3.org/International/techniques/authoring-html" class="external text" title="https://www.w3.org/International/techniques/authoring-html">Internationalization techniques: Authoring HTML & CSS</a>, which provides more fine-grained access to information.</p> | |||
<p>You can also find resources using the page <a href="https://www.w3.org/International/techniques/authoring-html" class="external text" title="https://www.w3.org/International/techniques/authoring-html">Internationalization techniques: Authoring web pages</a>, which provides more fine-grained access to information.</p> |
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.
I know that Richard has slightly different preferences, but I think we should discuss them (and add the results to our style guide for posterity).
I tend to think that we should use "Elements of Style" title case, which capitalizes most words (except articles and prepositions). That would make this document:
Internationalization Techniques: Authoring Web Pages
Separately I would note that W3C tends to capitalize Web, which makes "Authoring Web pages" look odd.
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.
In fact, i think it was this year, or maybe last, W3C Comm team issued guidance that said that the word 'web' would mostly be lowercase, and only uppercase when referring to 'the Web'. Terms like 'web page' would be lowercase.
@aphillips i had similar thoughts to you, but i'm not sure whether you are advocating that the headings themselves should be capitalised, or just the link text. I would like to maintain our downstyle approach for the headings themselves, but am inclined to support having capitalised link text.
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.
I'm OK with either one, as long as it's consistent.
See also:
Per 2024-05-16 teleconference discussion, merging this PR as is. |
No description provided.