From 531aa752b39f8419856d91acdb0b0a8210a2cbc3 Mon Sep 17 00:00:00 2001
From: John Heitmann <jheitmann@gmail.com>
Date: Mon, 13 Jun 2016 21:20:21 -0700
Subject: [PATCH] Minor DateTime intro doc update
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

• Put timezone in the lede since it's critical.
• Mention Instant and SystemTime to put DateTime in context
---
 README.md | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 423e886..2779ca8 100644
--- a/README.md
+++ b/README.md
@@ -53,9 +53,18 @@ provided by crates.io `time` crate (which originally comes from Chrono).
 
 ### Date and Time
 
-Chrono provides a `DateTime` type for the combined date and time.
+Chrono provides a
+[`DateTime`](https://lifthrasiir.github.io/rust-chrono/chrono/datetime/struct.DateTime.html)
+type to represent a date and a time in a timezone.
 
-`DateTime`, among others, is timezone-aware and must be constructed from
+For more abstract moment-in-time tracking such as internal timekeeping
+that is unconcerned with timezones, consider
+[`time::SystemTime`](https://doc.rust-lang.org/std/time/struct.SystemTime.html),
+which tracks your system clock, or
+[`time::Instant`](https://doc.rust-lang.org/std/time/struct.Instant.html), which
+is an opaque but monotonically-increasing representation of a moment in time.
+
+`DateTime` is timezone-aware and must be constructed from
 the `TimeZone` object.
 `DateTime`s with different time zones do not mix, but can be converted to
 each other using the `DateTime::with_timezone` method.