~ edits

Author: ilya-g

README.md

@@ -48,14 +48,30 @@ val datetimeInSystemZone: LocalDateTime = currentMoment.toLocalDateTime(TimeZone
 ```
 
 `LocalDateTime` instance exposes familiar components of the Gregorian calendar: 
-`year`, `month`, `dayOfMonth`, `hour`, and so on up to `nanosecond`. 
+`year`, `month`, `dayOfMonth`, `hour`, and so on up to `nanosecond`.
+The property `dayOfWeek` shows what weekday that date is,
+and `dayOfYear` shows the day number since the beginning of a year.
+
 
 Additional time zones can be acquired by their string identifier with the `TimeZone.of(id: String)` function.
 ```kotlin
 val tzBerlin = TimeZone.of("Europe/Berlin")
 val datetimeInBerlin = currentMoment.toLocalDateTime(tzBerlin)
 ```
 
+`LocalDateTime` instance can be constructed from individual components:
+
+```kotlin
+val kotlinReleaseDateTime = LocalDateTime(2016, 2, 15, 16, 57, 0, 0)
+```
+
+An instant can be obtained from `LocalDateTime` by interpreting it as a time moment
+in a particular `TimeZone`:
+
+```kotlin
+val kotlinReleaseInstant = kotlinReleaseDateTime.toInstant(TimeZone.of("UTC+3"))
+```
+
 ### Getting local date components
 
 `LocalDate` type represents local date without time. You can obtain it from `Instant`
@@ -67,6 +83,11 @@ val today: LocalDate = now.toLocalDateTime(TimeZone.SYSTEM).date
 ```
 Note, that today's date really depends on the time zone in which you're observing the current moment.
 
+`LocalDate` can be constructed from three components, year, month, and day:
+```kotlin
+val knownDate = LocalDate(2020, 2, 21)
+```
+
 ### Converting instant to and from unix time
 
 An `Instant` can be converted to unix millisecond time with the `toUnixMillis()` function.
@@ -88,17 +109,16 @@ val instantBefore = Instant.parse("2010-06-01T22:19:44.475Z")
 Alternatively, `String.to...()` extension functions can be used instead of `parse`, 
 where it feels more convenient:
 
+`LocalDateTime` uses the similar format, but without `Z` UTC time zone designator in the end.
+
+`LocalDate` uses format with just year, month, and date components, e.g. `2010-06-01`.
+
 ```kotlin
 "2010-06-01T22:19:44.475Z".toInstant()
 "2010-06-01T22:19:44".toLocalDateTime()
 "2010-06-01".toLocalDate()
 ```
 
-`LocalDateTime` uses the similar format, but without `Z` UTC time zone designator in the end.
-
-`LocalDate` uses format with just year, month, and date components, e.g. `2010-06-01`.
-
-
 ### Instant arithmetic
 
 ```kotlin
@@ -166,4 +186,8 @@ git submodule init
 git submodule update
 ```
 
+The path to JDK 8 must be specified either with the environment variable `JDK_8` or 
+with the gradle property `JDK_8`. For local builds, you can use a later version of JDK if you don't have that 
+version installed.
+
 After that, the project can be opened in IDEA and built with Gradle.