Emphasize that durations are context independent.

sdk/lib/core/duration.dart

Index: sdk/lib/core/duration.dart
diff --git a/sdk/lib/core/duration.dart b/sdk/lib/core/duration.dart
index c5b73a2c86c0eaf05bfc5816dd9358802ab3a0a6..ee074d1568f0b1dbf80db63919b89ddf44e4fafa 100644
--- a/sdk/lib/core/duration.dart
+++ b/sdk/lib/core/duration.dart
@@ -11,6 +11,15 @@ part of dart.core;
  * duration may be "negative" if the difference is from a later time to an
  * earlier.
  *
+ * Durations are context independent. For example, a duration of 2 days is
+ * always 48 hours, even when it is added to a `DateTime` just when the
+ * time zone is about to do a daylight-savings switch. (See [DateTime.add]).
+ *
+ * Despite the same name, a `Duration` object does not implement "Durations"
+ * as specified by ISO 8601. In particular, a duration object does not keep
+ * track of the individually provided members (such as "days" or "hours"), but
+ * only uses these arguments to compute the corresponding time intervall.

[Lasse Reichstein Nielsen, 2016/10/17 12:40:12]

compute the corresponding -> compute the length of the corresponding

[floitsch, 2016/10/17 12:50:25]

Done.

+ *
  * To create a new Duration object, use this class's single constructor
  * giving the appropriate arguments:
  *