57: Added definition for s (second) as per 9th Draft SI Brochure

[teobais]

The way the equations are herewith represented is something I personally don't like that much (we're not in Latex unfortunately 😂 ), but I would be interested in the views of the rest as well.

---

This change is 

[desruisseaux]

I would suggest to add some sentence saying that the definition of second in this javadoc is only informative. The normative part of JSR-385 specification could be the requirement to use SI definition (if we want to put that requirement - Werner, is it the case?). Then we can reproduce that definition in the comment for information purpose, but in case of doubt, typo or update from SI, the definition published by SI is normative. It could be just adding a sentence like: "This quantity is measured by a unit defined by SI as below (informative):". If the definition is copied from SI verbatim, then I suggest to put it in a HTML <blockquote> element, or any other way showing that we are quoting.

[keilw]

Where possible we should use the (new) SI definition.

[teobais]

So, we leave it as is (?) or am I missing something?

[desruisseaux]

I'm neutral on whether we leave it as is or not. My point was that if we want JSR-385 to be aligned on latest SI definition, then the javadoc should point to the SI definition and make clear that the copied text is only informative (i.e. that users should check the SI web site for most up-to-date definition).

[teobais]

Good point @desruisseaux . However, in order to avoid commits that might need to be changed before merging this, I would suggest that @keilw provides us with a specific direction.