diff --git a/README.rst b/README.rst index c14f1fe..1cdf1f7 100644 --- a/README.rst +++ b/README.rst @@ -2,7 +2,11 @@ Maya: Datetime for Humans™ ========================== Datetimes are very frustrating to work with in Python, especially when dealing -with different locales on different systems. This library exists to make the simple things easier, while admitting that time is an illusion (timezones doubly so), and should be interacted with via an API for humans (not machines). +with different locales on different systems. This library exists to make the +simple things **much** easier, while admitting that time is an illusion +(timezones doubly so). + +Datetimes should be interacted with via an API written for humans. The Usage --------- @@ -50,11 +54,12 @@ Just playing with an API here: -Timezones fit more in here somewhere... - - Notes ----- +- All timezone algebra will behave identically on all machines, regardless of system locale. +- Complete symmetric import and export of both ISO 8601 and RFC 2822 datetime stamps. +- Fantastic parsing of both dates written for/by humans and machines (``maya.when()`` vs ``maya.parse()``). +- Support for human slang, both import and export (e.g. `an hour ago`). - This library is based around epoch time, but dates before Jan 1 1970 are indeed supported, via negative integers. - Don't panic, and always carry a towel.