From 26854b4b83d570f53935af6319d0167cf5d63ea5 Mon Sep 17 00:00:00 2001 From: pseudocoder Date: Thu, 10 Oct 2019 13:54:01 +0300 Subject: [PATCH 1/2] DOCS: add mention of swagger api reference 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 8e0b43ec241c2..624d639545c96 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 From 84481a833cb4cbd82de7d9fd045e07eb50724668 Mon Sep 17 00:00:00 2001 From: pseudocoder Date: Wed, 18 Dec 2019 15:42:29 +0200 Subject: [PATCH 2/2] Add warning to avoid template mismatches Related to https://github.com/go-gitea/gitea/issues/9320 --- docs/content/doc/advanced/customizing-gitea.en-us.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/content/doc/advanced/customizing-gitea.en-us.md b/docs/content/doc/advanced/customizing-gitea.en-us.md index 89b4a489cbc10..5a98375dd73e2 100644 --- a/docs/content/doc/advanced/customizing-gitea.en-us.md +++ b/docs/content/doc/advanced/customizing-gitea.en-us.md @@ -65,7 +65,7 @@ Place the png image at the following path: `custom/public/img/avatar_default.png ## Customizing Gitea pages The `custom/templates` folder allows changing every single page of Gitea. Templates -to override can be found in the [`templates`](https://github.com/go-gitea/gitea/tree/master/templates) directory of Gitea source. Override by +to override can be found in the [`templates`](https://github.com/go-gitea/gitea/tree/master/templates) directory of Gitea source (Note: the example link is from `master` branch. Make sure to copy templates from same release you are using). Override by making a copy of the file under `custom/templates` using a full path structure matching source.