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

Add info about HTML and JS new features #327

Open
wants to merge 22 commits into
base: gh-pages
Choose a base branch
from
Open

Conversation

xfq
Copy link
Member

@xfq xfq commented Dec 2, 2021

Fix #7.

Changes:

  • Remove "intended audience"
  • Change the question from "How do I prepare my web pages to display varying international date formats?" to "How do I manage date formats on a web page?"
  • Divide the article into two parts: input and output of dates
  • Mention the date & time markup in HTML5
  • Mention the JavaScript Date object (I choose not to mention Temporal for now, because I want to wait until there are at least two shipping implementations)
  • Remove the information on Java/JSP, ASP, and Perl. I don't think these can provide much guidance to developers nowadays, because Java/Spring and PHP are much more popular.

Preview

@xfq xfq requested a review from r12a December 2, 2021 11:51
@r12a
Copy link
Contributor

r12a commented Aug 16, 2022

@xfq i just came across this. Do you want to continue to make these changes? If so, i think we need to solve the conflicts first. Then i have a number of suggestions ranging from organisation of sections to typos.

@xfq
Copy link
Member Author

xfq commented Aug 17, 2022

Do you want to continue to make these changes?

Yes. I have resolved the conflicts.

@r12a
Copy link
Contributor

r12a commented Aug 17, 2022

ac0a810#diff-925e46831aa6b3e93b26574309eda5813c4092dc831e2dfa6757c86b0a167c72 is showing a massive number of changes to the repo. I'm not sure what that's about, and whether it means all the files mentioned will be updated (which is not a good idea). Could you take a look and let me know?

@xfq
Copy link
Member Author

xfq commented Aug 17, 2022

That's normal, as I need to resolve the merge conflicts. Those modifications are already in the gh-pages branch.

@himorin
Copy link
Contributor

himorin commented Aug 17, 2022

That's normal, as I need to resolve the merge conflicts. Those modifications are already in the gh-pages branch.

In addition, some more explanation. When some branch is created at 100th history of HEAD, and bunch of updates are committed to HEAD during discussion held in PR of the branch - like 170th HEAD, the branch is ahead of HEAD over 70 commits. If there is conflict(s) between PR and ones during 70 commits, conflicted file(s) are required to be resolved. For this, there are several ways, like:

  • take updates between 100th and 170th HEAD, per file which is modified within the PR (named as resolve conflict button on merging)
  • just rebase from 100th to 170th HEAD, like modify history of PR from '100th HEAD -> commit for PR' to '170th HEAD -> commit for PR', which results to modify the PR as started from 170th HEAD
  • merge from origin/HEAD to the PR, which applies all modification happened on HEAD, like taking all commits between 100th and 170th into the PR (history will be 100th HEAD -(fork)-> commit for PR -> all changes between 100-170)

For the last, commit for merging all changes (e.g. 100th to 170th in example above) will be shown lie ac0a810, but Files changed tab in PR will show will show only changes between 170th HEAD and the PR which is similar to the original change for the PR.

@xfq
Copy link
Member Author

xfq commented Aug 17, 2022

Thanks for your explanation, @himorin!

questions/qa-date-format.en.html Outdated Show resolved Hide resolved
questions/qa-date-format.en.html Show resolved Hide resolved
questions/qa-date-format.en.html Show resolved Hide resolved
questions/qa-date-format.en.html Outdated Show resolved Hide resolved
questions/qa-date-format.en.html Outdated Show resolved Hide resolved
questions/qa-date-format.en.html Outdated Show resolved Hide resolved
questions/qa-date-format.en.html Outdated Show resolved Hide resolved
questions/qa-date-format.en.html Outdated Show resolved Hide resolved
<p>Use <code>$ENV{'HTTP_ACCEPT_LANGUAGE'}</code> to get the preferred language. Use <code>POSIX:strftime</code> to format date values.
You'll have to do your own mapping of the accepted languages value to a date format string.</p>
</div>
<p>How this is done will vary depending on your development environment.</p>
Copy link
Contributor

Choose a reason for hiding this comment

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

The section "Store and display a date" also seems to lack focus. In fact, i think it's trying to do 2 separate things:

  1. describe how local date/time formats can be different and problematic, and what works or doesn't work if you try to use a generic format
  2. describe how to produce dates and times in your code (one method described is that using JavaScript – but it doesn't mention the time element in HTML

Is option 3 really something useful these days? Or is it part of the discussion "How language interacts with date/time settings and where to get the language from" ?

Copy link
Member Author

Choose a reason for hiding this comment

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

Do you have any specific suggestions? I think option 3 is still useful. Do you think it should be removed or split into a separate article?

questions/qa-date-format.en.html Show resolved Hide resolved
@netlify
Copy link

netlify bot commented Feb 8, 2023

Deploy Preview for i18n-drafts ready!

Name Link
🔨 Latest commit 2f3f6ba
🔍 Latest deploy log https://app.netlify.com/sites/i18n-drafts/deploys/66d6a04afabff20008834a56
😎 Deploy Preview https://deploy-preview-327--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.

@w3c w3c deleted a comment from netlify bot Feb 8, 2023
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.

in progress

@@ -56,21 +59,104 @@ <h1>Date formats</h1>


<section id="question">
<h2>Question</h2>
<p class="question">How do I prepare my web pages to display varying international date formats?</p>
<p>Visitors to a web site from varying locales may be confused by date formats. The format MM/DD/YY is unique to the United States (but sometimes used in Canada, too, which can obviously create some confusion there). Most of Europe uses DD/MM/YY. Japan uses YY/MM/DD. The separators may be slashes, dashes or periods. Some locales print leading zeroes, others suppress them. If a native Japanese speaker is reading a US English web page from a web site in Germany that contains the date 03/04/02 how do they interpret it?</p>
Copy link
Contributor

Choose a reason for hiding this comment

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

This paragraph (which you didn't touch) is misleading. There are many formats in use. The field order problem is only part of the issue.

Copy link
Member Author

Choose a reason for hiding this comment

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

The field order problem is, IMHO, the most obvious and confusing issue for web users. This paragraph also mentions the separator differences, and leading zeros, etc.

I know there are other problems that are not mentioned, such as whether to use month names, whether the year is 2 or 4 digits, whether the numbers are full-width or half-width (in CJK), which calendar to use, etc. Do these also need to be mentioned at the beginning of the article? Or should we write a separate article to talk about various date formats, just like our article on font styles and line breaking?

questions/qa-date-format.en.html Outdated Show resolved Hide resolved
@xfq
Copy link
Member Author

xfq commented Sep 24, 2024

Discussions during TPAC 2024: https://www.w3.org/2024/09/23-i18n-minutes.html#t03

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.

[questions/qa-date-format] add info about html5 date markup
4 participants