From eac5a8be751341b388cf16c5a43aeb2f83c8ed2c Mon Sep 17 00:00:00 2001
From: pseudocoder <borisovano@users.noreply.github.com>
Date: Thu, 10 Oct 2019 15:42:01 +0300
Subject: [PATCH] DOCS: add mention of swagger api reference (#8452)

It's(swagger api link) mentioned vaguely in the FAQ but IMHO missing from API usage page.
---
 docs/content/doc/advanced/api-usage.en-us.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/content/doc/advanced/api-usage.en-us.md b/docs/content/doc/advanced/api-usage.en-us.md
index 8e0b43ec24..624d639545 100644
--- a/docs/content/doc/advanced/api-usage.en-us.md
+++ b/docs/content/doc/advanced/api-usage.en-us.md
@@ -68,6 +68,14 @@ curl -X POST "http://localhost:4000/api/v1/repos/test1/test1/issues" \
 As mentioned above, the token used is the same one you would use in
 the `token=` string in a GET request.
 
+## API Guide:
+
+API Reference guide is auto-generated by swagger and available on: 
+    `https://gitea.your.host/api/swagger`
+    or on 
+    [gitea demo instance](https://try.gitea.io/api/swagger)
+
+
 ## Listing your issued tokens via the API
 
 As mentioned in