doc/index: Initial commit

diff --git a/doc/index.md b/doc/index.md
new file mode 100644 (file)
index 0000000..6c08c24
--- /dev/null
+++ b/doc/index.md
@@ -0,0 +1,26 @@
+# `luatz`
+
+Requiring the base luatz module will give you a table of commonly used functions and submodules.
+
+The table includes the following sub modules, which have their own documentation:
+
+  - `parse`: Parses common date/time formats
+  - `timetable`: Class for date/time objects supporting normalisation
+
+
+## `time ( )`
+
+Returns the current unix timestamp using the most accurate source available.
+See `gettime` for more information.
+
+
+## `get_tz ( timezone_name )`
+
+Returns a timezone object (see `tzinfo` documentation) for the given `timezone_name`.
+This uses the local zoneinfo database; names are usually of the form `Country/Largest_City`.
+
+
+## `time_in ( timezone_name [, utc_ts] )`
+
+Returns the current time in seconds since 1970-01-01 0:00:00 in the given timezone
+(as a string, e.g. "America/New_York") at the given UTC time (defaults to now).