Move API from AWS to GitHub Pages

[IvanGoncharov]

GitHub now supports custom domains so we can move api.apis.guru to gh_pages branch of this repo:
https://blog.github.com/2018-05-01-github-pages-custom-domains-https/
Probably makes sense to deploy using Travis:
https://docs.travis-ci.com/user/deployment/pages/

[IvanGoncharov]

@MikeRalphson What do you think?

[MikeRalphson]

Sounds good. Will have a go at deploying to the gh-pages branch first and then look at switching the domain over.

[rbren]

FYI - I usually have an easier time deploying to the docs/ folder on the master branch. That way you can easily put your build script in package.json

[MikeRalphson]

Thanks @bobby-brennan but in this case I think having the deployed APIs also visible in a docs/ folder in the main branch would be confusing.

[MikeRalphson]

@IvanGoncharov deploy dir now pushed to gh-pages branch. Is that ok, or does it need to live inside a v2 subdirectory?

[IvanGoncharov]

@MikeRalphson Without v2 it would be a breaking change. Plus versioning allows you to switch JSON format in the future, e.g. provide only OAS3 urls.

[MikeRalphson]

@IvanGoncharov I wasn't querying the need for /v2/ in the current paths, I was trying to ask which files/directories in the current deploy directory / root of gh-pages need to be under v2?

[IvanGoncharov]

Same as S3 all content of deploy dir:

[MikeRalphson]

Directory structure of gh-pages branch should be OK now.

[rbren]

FYI - I think you'll need a proxy like CloudFlare or AWS CloudFront to maintain support for HTTPS

relevant issue

[MikeRalphson]

@bbrennan isn't that exactly the issue addressed by the blog posting Ivan linked to initially (https://blog.github.com/2018-05-01-github-pages-custom-domains-https/)? One person who needed www. support as well should not block us.

[rbren]

Oh nice! I missed that, thanks

…

On Wed, May 9, 2018, 1:58 AM Mike Ralphson ***@***.***> wrote: @bbrennan <https://github.com/bbrennan> isn't that exactly the issue addressed by the blog posting Ivan linked to initially ( https://blog.github.com/2018-05-01-github-pages-custom-domains-https/)? One person who needed www. support as well should not block us. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#397 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AHQmRfR9cQx3jt6Qw9bCd5R5lCarLxrfks5twoWUgaJpZM4Tv1HX> .

[IvanGoncharov]

Migration completed a few weeks ago ⏳
Everything is working 👍