From 7065a6124c1ed2cad1515904bfa60259df23a1bf Mon Sep 17 00:00:00 2001
From: Tony Lee <tungsheng@gmail.com>
Date: Tue, 19 Jun 2018 03:37:26 +0800
Subject: [PATCH] add api user guides in doc

---
 docs/content/doc/user-guides.en-us.md              | 13 +++++++++++++
 docs/content/doc/user-guides/api-authentication.md | 12 ++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 docs/content/doc/user-guides.en-us.md
 create mode 100644 docs/content/doc/user-guides/api-authentication.md

diff --git a/docs/content/doc/user-guides.en-us.md b/docs/content/doc/user-guides.en-us.md
new file mode 100644
index 000000000..468289cbb
--- /dev/null
+++ b/docs/content/doc/user-guides.en-us.md
@@ -0,0 +1,13 @@
+---
+date: "2018-06-19T16:00:00+02:00"
+title: "User-guides"
+slug: "user-guides"
+weight: 45
+toc: false
+draft: false
+menu:
+  sidebar:
+    name: "User-guides"
+    weight: 45
+    identifier: "user-guides"
+---
diff --git a/docs/content/doc/user-guides/api-authentication.md b/docs/content/doc/user-guides/api-authentication.md
new file mode 100644
index 000000000..a28619bc3
--- /dev/null
+++ b/docs/content/doc/user-guides/api-authentication.md
@@ -0,0 +1,12 @@
+# API user guide
+
+## User
+
+### /users/{username}/tokens
+
+Basic usage:
+
+```
+$ curl --request GET --url https://m:mypassword@git.your.host/api/v1/users/m/tokens
+[{"name":"test","sha1":"..."},{"name":"dev","sha1":"..."}]
+```