google / google/styleguide

No word about standard date format in lispguide.xml, how about http://www.w3.org/TR/NOTE-datetime

Open
#11 0 comments 0 reactions 0 assignees View on GitHub
auto-migrated enhancement
Dominant language
HTML
Stars
39.6k
Forks
12.9k
Avg merge
42m
Merged PRs (30d)
15

Description

```
What steps will reproduce the problem?
1.
https://google-styleguide.googlecode.com/svn/trunk/lispguide.xml?showone=Attenti
on_Required#Attention_Required
2.
3.

What is the expected output? What do you see instead?

I would expect the "Google Common Lisp Style Guide" to specify the format dates
in comments should be in. My strong preference would be towards ISO 8601, to
spare readers the bafflement which is 1/2/3 or 03.02.01.

The only mention of date is in the example below.
While "November, 2012" is unambiguous enough, it leaves the reader with no
recommendation for representing specific dates or date-time.

Here is the excerpt:

Be specific when indicating times or software releases in a TODO comment:

;;--- TODO(brown): Remove this code after release 1.7 or before November, 2012.

What version of the product are you using? On what operating system?

Please provide any additional information below.

Using a standard date-time format would make it a lot easier for humans and for
tooling to extract useful temporal information from program comments.

```

Original issue reported on code.google.com by `adrian.a...@gmail.com` on 11 Oct 2012 at 11:31

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.