Update README

Author: kean

README.md

@@ -5,32 +5,33 @@
 <img src="https://github.com/kean/Nuke/workflows/NaiveDate%20CI/badge.svg">
 </p>
 
-`Date` type is great for working with time zones (e.g. `2017-09-29T15:00:00+0300`), however, there are scenarios in which **naive** dates and times are desirable.
+Native `Date` type is great for working with time zones (e.g. `2017-09-29T15:00:00+0300`), but there are scenarios where you don't know or care about the time zone. These types of dates are often called **naive**.
 
 
 ## Usage
 
-The library implements three types:
-- `NaiveDate` (e.g. `2017-09-29`)
+The `NaiveDate` library implements three types:
+
+- `NaiveDate` (e.g. `2021-09-29`)
 - `NaiveTime` (e.g. `15:30:00`)
-- `NaiveDateTime` (e.g. `2017-09-29T15:30:00` - no time zone and no offset).
+- `NaiveDateTime` (e.g. `2021-09-29T15:30:00` - no time zone and no offset).
 
-Each of them implements `Equatable`, `Comparable`, `LosslessStringConvertible`, `Codable` protocols. Naive types can also be converted to  `Date`, and `DateComponents`.
+They all implement `Equatable`, `Comparable`, `LosslessStringConvertible`, and `Codable` protocols. Naive date types can also be converted to `Date`, and `DateComponents`.
 
 ### Create
 
-Naive dates and times can be created from a string (using a predefined format), using `Decodable`, or with a memberwise initializer:
+Naive dates and times can be created from a string (using a predefined format – [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6), using `Decodable`, or with a memberwise initializer:
 
 ```swift
-NaiveDate("2017-10-01")
-NaiveDate(year: 2017, month: 10, day: 1)
+NaiveDate("2021-10-01")
+NaiveDate(year: 2021, month: 10, day: 1)
 
 NaiveTime("15:30:00")
 NaiveTime(hour: 15, minute: 30, second: 0)
 
-NaiveDateTime("2017-10-01T15:30")
+NaiveDateTime("2021-10-01T15:30")
 NaiveDateTime(
-    date: NaiveDate(year: 2017, month: 10, day: 1),
+    date: NaiveDate(year: 2021, month: 10, day: 1),
     time: NaiveTime(hour: 15, minute: 30, second: 0)
 )
 ```
@@ -40,39 +41,39 @@ NaiveDateTime(
 Format dates without having to worry about time zones:
 
 ```swift
-let date = NaiveDate("2017-11-01")!
+let date = NaiveDate("2021-11-01")!
 NaiveDateFormatter(dateStyle: .short).string(from: date)
-// prints "Nov 1, 2017"
+// prints "Nov 1, 2021"
 
 let time = NaiveTime("15:00")!
 NaiveDateFormatter(timeStyle: .short).string(from: time)
 // prints "3:00 PM"
 
-let dateTime = NaiveDateTime("2017-11-01T15:30:00")!
+let dateTime = NaiveDateTime("2021-11-01T15:30:00")!
 NaiveDateFormatter(dateStyle: .short, timeStyle: .short).string(from: dateTime)
-// prints "Nov 1, 2017 at 3:30 PM"
+// prints "Nov 1, 2021 at 3:30 PM"
 ```
 
 ### Convert
 
-When you do need time zones, convert `NaiveDate` to `Date`:
+When you do need to work with time zones, simply convert `NaiveDate` to `Date`:
 
 ```swift
-let date = NaiveDate(year: 2017, month: 10, day: 1)
+let date = NaiveDate(year: 2021, month: 10, day: 1)
 
 // Creates `Date` in a calendar's time zone
-// "2017-10-01T00:00:00+0300" if user is in MSK
+// "2021-10-01T00:00:00+0300" if user is in MSK
 Calendar.current.date(from: date)
 ```
 
 ```swift
 let dateTime = NaiveDateTime(
-    date: NaiveDate(year: 2017, month: 10, day: 1),
+    date: NaiveDate(year: 2021, month: 10, day: 1),
     time: NaiveTime(hour: 15, minute: 30, second: 0)
 )
 
 // Creates `Date` in a calendar's time zone
-// "2017-10-01T15:30:00+0300" if user is in MSK
+// "2021-10-01T15:30:00+0300" if user is in MSK
 Calendar.current.date(from: dateTime)
 ```