[Meta] Improvements to the API about gitea

[lunny]

+1

[lunny]

@bkcsoft I updated the issue, seems almost done. 😄

[Serkan-devel]

Will the GraphQL-API be supported?

[tboerger]

Maybe a project should be better to keep an overview of missing parts.

[tboerger]

We should create issues for all of that.

[bkcsoft]

@lunny I have a few PRs coming, but I'll continue with the rest of the API after that starting with Status API :)

[bkcsoft]

@tboerger Should this be a "Project" instead maybe?

[hhenkel]

One point I already mentioned on the gitter channel yesterday, IMHO there is a need for automatic documentation (from code / comments in the code) of the api. I think this should be added to this list, there is an initial issue in go-gogs-client mentioning one of the current issues with the docs: gogs/go-gogs-client#46

It seems swagger is the most popular solution currently and it seems there is a go implementation

[metalmatze]

Yep 👍 for swagger

[bkcsoft]

@tboerger AFAIK it's hard to make generic comments (like @hhenkel just did) on a Project?

[lunny]

I think this should be the emphasis of v1.1. So we have to list all the APIs should github have. And implements it one by one. For example, we can implement https://developer.github.com/v3/repos/statuses first?

[pyhedgehog]

Please add API for POST /api/v1/repos/:owner/:repo/forks. It's very important feature.

[bkcsoft]

@pyhedgehog Please make an issue for that, since this is just a Meta-issue for tracking API-changes 🙂

[pyhedgehog]

@bkcsoft, #477 + #494.

[bkcsoft]

@lunny

and don't set a milestone either since it's long-running

[lunny]

OK

[tboerger]

But since it will be done within the 1.x.x livetime I will set it to 1.x.x milestone

[bkcsoft]

(GitHub needs more reactions! )

[stevegt]

Mentioning #3076 (add github compatible v3 routes) here for searchability.

[lunny]

There is an issue to report that.

[6543]

beside api unrelated & feed API, everything is here.

should we close this now?

[6543]

ok since https://github.com/go-gitea/gitea/issues?q=is%3Aissue+is%3Aopen+label%3Akind%2Fapi+label%3Akind%2Fproposal

summary it well, I'll close this now - if there is a need for a summary issue on API stuff, just ask and I'll open a new one :)