From 6fbe5a8085da9fbe3c0ee959c8c57c83e2c2c346 Mon Sep 17 00:00:00 2001
From: PoiScript <poiscript@gmail.com>
Date: Sun, 15 Sep 2019 23:32:37 +0800
Subject: [PATCH] docs(sync): add README.md

---
 orgize-sync/Cargo.toml |  5 +++
 orgize-sync/README.md  | 84 ++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 orgize-sync/README.md

diff --git a/orgize-sync/Cargo.toml b/orgize-sync/Cargo.toml
index 8c64839..402bc02 100644
--- a/orgize-sync/Cargo.toml
+++ b/orgize-sync/Cargo.toml
@@ -2,7 +2,12 @@
 name = "orgize-sync"
 version = "0.1.0"
 authors = ["PoiScript <poiscript@gmail.com>"]
+description = "Sync your Org with your favourite applications."
+repository = "https://github.com/PoiScript/orgize"
+readme = "README.md"
 edition = "2018"
+license = "MIT"
+keywords = ["orgmode"]
 
 [package.metadata.docs.rs]
 all-features = true
diff --git a/orgize-sync/README.md b/orgize-sync/README.md
new file mode 100644
index 0000000..8b8f7f6
--- /dev/null
+++ b/orgize-sync/README.md
@@ -0,0 +1,84 @@
+# Orgize-sync
+
+Sync your Org with your favourite applications.
+
+> This project is still in *alpha stage*. Don't forget to backup
+> your orgmode files before trying!
+
+## Commands
+
+### `Init`
+
+// TODO
+
+### `Sync`
+
+// TODO
+
+### `Conf`
+
+// TODO
+
+## Configuration
+
+### General
+
+> Field with default value is optional.
+
+**Global**:
+
+``` toml
+# path to dotenv file
+env_path = "./.env"   # default is `${UserCache}/orgize-sync/.env`
+
+# number of days to filter headline before today
+up_days = 1           # default is 7
+# number of days to filter headline after today
+down_days = 1         # default is 7
+```
+
+**Pre-file**:
+
+``` toml
+[[file]]
+# path to this orgmode file, required
+path = "./notes.org"
+# specify a name for this file, optional
+name = "note"
+```
+
+### Google Calendar
+
+**Global**:
+
+``` toml
+[google_calendar]
+# google oauth client id and client_secret, required
+client_id = "xxx"     # or environment variable `GOOGLE_CLIENT_ID`
+client_secret = "xxx" # or environment variable `GOOGLE_CLIENT_SECRET`
+
+# redirect url after authorizing
+redirect_uri = ""     # default is `http://localhost`
+
+# control where to store access token and refresh token
+token_dir = ""        # default is `${UserCache}/orgize-sync`
+token_filename = ""   # default is `google-token.json`
+```
+
+**Pre-file**:
+
+``` toml
+[[file]]
+# other fields ...
+[file.google_calendar]
+# which calendar to sync, required
+calendar = ""
+
+# whether to append new calendar event to the org mode
+append_new = false    # default is true
+# where to append new calendar event
+append_headline = ""  # default is `Sync`
+
+# which property to store event id
+property = ""         # default is `EVENT_ID`
+```