Skip to content
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

Merged
merged 2 commits into from May 17, 2024
Merged

Conversation

xfq
Copy link
Member

@xfq xfq commented Oct 11, 2023

No description provided.

@netlify
Copy link

netlify bot commented Oct 11, 2023

Deploy Preview for i18n-drafts ready!

Name Link
🔨 Latest commit 53d8b0e
🔍 Latest deploy log https://app.netlify.com/sites/i18n-drafts/deploys/6646c52a3a0a7f0008f47fde
😎 Deploy Preview https://deploy-preview-550--i18n-drafts.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@r12a
Copy link
Contributor

r12a commented Oct 11, 2023

LGTM as long as it's always clear from the link or the styling that this is the title of a document.

Copy link
Contributor

@aphillips aphillips left a 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

@@ -51,7 +51,7 @@
<div class="content">
<h1>Articles &amp; 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 &amp; 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>
Copy link
Contributor

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.

Copy link
Contributor

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.

Copy link
Member Author

Choose a reason for hiding this comment

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

@xfq xfq merged commit 8b415e0 into gh-pages May 17, 2024
4 checks passed
@xfq xfq deleted the xfq/authoring-html-20231011 branch May 17, 2024 02:48
@xfq
Copy link
Member Author

xfq commented May 17, 2024

Per 2024-05-16 teleconference discussion, merging this PR as is.

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.

None yet

3 participants