Feat/Kong-Studio (#1586)

* chore(ee/changelog) release 0.34-1 FT-358 (#210)

* docs(ee/changelog) 0.34-1 release

* chore(ee/changelog) remove trailing whitespace

* docs(openid-connect) updated doc to 2.7.0 version

* docs(edits) copy and style edits

* chore(*) merge public repo (#211)

* chore(*) merge public repo

* chore(*) merge public repo (#219)

* feat(docs): 0.35 Release Base

* docs(35): Bump EE Latest Version (#232)

* update travis node version

* docs(35) navigation (#231)

* feat(nav): Adds 3 level navigation (#233)

* docs(35/deployment) copy licensing section (#220)

* Docs/35 nav (#235)

* docs(35) navigation updates

* docs(35): Dev Portal Init

* docs(35/deployment) (#238)

* docs(35/docker) (#222)

* docs(35/centos) (#223)

* docs(35/amazon-linux) (#224)

* fix 35 nav formatting

* docs(nav) remove duplicate sections

* docs(35/km/overview) copy old overview

* docs(35/km/overview) replace start with networking

* docs(35/km/overview) clarify section

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) move workspaces above rbac

* refactor(35/km/overview) fix new lines

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) admins rewording

* docs(35/km/overview) networking button rewording

* docs(35/km/overview) reword workspaces

* fix(35): Add index.md

* fix(35): Update Admin API Nav (#244)

* fix(35): Update Admin API Nav

* feat(docs): 35 Index Page Init (#246)

* Docs/35 dev portal config (#247)

* docs(dev-portal): Auth types

* Docs/35 dev portal config (#248)

* add warning to basic auth

* add workspaces

* docs(35): Audit Log (#249)

* docs(35): Vitals (#239)

* docs(35): Dev Portal Networking Ref (#243)

* docs(35): Property Reference  (#251)

* docs(35/manager) Kong Manager TD-121 (#245)

For RC only

* docs(35)/dev-portal (#236)

* Docs/35 temp plugins (#252)

* Revert "docs(35)/dev-portal (#236)" (#253)

This reverts commit 0d9c2afad73734443ea73d367c15ef0da06e5c87.

* Docs/35 dev portal temp (#255)

* Docs/getting started temp (#257)

* docs(35/prop-ref) correct name of prop

* docs(35) Admin API (#258)

* docs(35) administration (#259)

* docs(35) remove ad from nav

* docs(35) update admin

* docs(35) reposition nav (#260)

* docs(35) navigation improvements and fixes (#261)

* docs(35) refine getting started (#262)

* docs(35/admin) update reference docs (#263)

* alter nav for rc (#264)

* docs(35/km/auth/oidc) close bracket

Thank you, @Jlawlzz .

* docs(35/admin-api) add examples and corrections (#265)

* fix(35) add items to navigation (#266)

* fix(35/nav) remove typo in nav

* docs(35/admin/example) MVP walkthrough (#267)

* docs(35) start securing km section

* docs(35/getting-started) feedback corrections

* docs(35/admins/ref) add missing attributes (#269)

* docs(35/*) provide security documentation (#270)

* docs(35/km/oidc) improve OIDC (#271)

* docs(35/start) add a note that only one super admin may be seeded

* docs(35) add warning about samesite (#273)

* docs(35/admins/ref) add generate_register_url description INTF-1506 (#272)

Review in staging.

* docs(35/plugin/session) add session doc (#275)

* fix(35/plugin/session) fix template type

* docs(35/getting-started) improve getting started intro (#274)

* docs(ldap-auth-advanced) change property name from ssl to ldaps (#268)

* docs(35/admin-api) update workspaces and rbac responses (#276)

* docs(35/rbac/api) update endpoint permission responses

* docs(35/rbac) permissions endpoints update

* docs(index): Update index grid (#278)

* docs(index): Update index grid

* docs(docker): Update installation commands (#277)

* docs(docker): Update installation commands

* docs(35): Add plugin redirects (#250)

* docs(35): Add plugin redirects

* Docs/35 plugins (#280)

* add redirects for jwt and rbh

* init dev portal files

* docs(35/*) session config and disclaimer (#283)

* Adds details to session configuration
* All places that suggest setting `enforce_rbac = on` now mention `admin_gui_session_conf`
* Adds a disclaimer to any example pertaining to `secret`, `cookie_secure`, and `cookie_samesite`
* All entry points (i.e. places that suggest setting `admin_gui_session_conf`) link to Kong Manager Session doc, which in turn links to Session Plugin after distinguishing the 2
* Clear statement that Session Plugin is required with any auth type
* General stylistic cleanup around the Session page titles

* docs(getting-started): Add grid overview (#282)

* hotfix(35/session) fix yml format

* add managing developers

* update nav for internal preview

* docs(vault-auth) add 0.1-x vault-auth docs (#216)

* docs(vault-auth) add 0.1-x vault-auth docs

* add dev portal docs

* add overview to getting started

* docs(35/km/ws) add note about admins without roles having "access" - EBB 90 (#281)

* docs(35/nav) remove install overview

* docs(35/nav) move down overview to distinct section

* docs(35/nav) flatten nav for upgrades

* docs(35/*) add migration guide

* docs(35/nav) remove aws guide link until update is ready

* hotfix(35/migrations) fix link

* hotfix(35/migrations) fix links

* docs(35/migrations) style the 'important' block

* docs(35/migrations) make external links open new windows

* docs(35/amazon-linux) fix migrations option

* docs(35/docker) fix migrations option

* docs(35/install) hide unused guides

* docs(35/*) fix config link

* fix(35/start) fix link

* fix(35/start) fix link

* fix(35/*) getting started links

* docs(35/*) add security sec

* dev portal updates

* Chore/public merge (#286)

- merge public repo

* fix merge conflicts

* merge public repo

* Release/0.35 3 (#294)

* docs(rate-limiting-advanced) add configuration parameter for redis cluster

* write(35/km) how to reset password and rbac token (#287)

* write(35/km) how to reset password and rbac token

* change hard links to header links

* fix bold formatted words

* fix list numbering

* change hard links to dynamic

* add page to navigation

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

Co-Authored-By: levi <[email protected]>

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* docs(enterprise/migrations) migrate-apis CLI guide (#289)

* chore(properties) add description fro db_cache_warmup_entities configuration (#290)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release (#291)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release

* apply suggestions from code review

* Add cli.md to enterprise doc tree (#292)

* chore(cli) duplicate core cli doc and add new enterprise migrations commands

* chore(nav) update nav to pick up new cli file

* copy updates

* changelog formatting

Adds references to API migration guide to 0.35 migration guide

* remove extra line

* Add Upstream TLS to Hub (#295)

* Add Upstream TLS to Hub

* Add to nav

* Clearer explanation for known issue

* Chore/public merge (#296)

* Update dependency lodash to v4.17.13 [SECURITY] (#1395)

* docs(add-plugin) delete unused page (#1400)

Topic covered in enable-plugin.

* add custom plugin apig-response-transform (#1365)

* Release/0.35-3 (#1406)

* chore(ee/changelog) release 0.34-1 FT-358 (#210)

* docs(ee/changelog) 0.34-1 release

* chore(ee/changelog) remove trailing whitespace

* docs(openid-connect) updated doc to 2.7.0 version

* docs(edits) copy and style edits

* chore(*) merge public repo (#211)

* chore(*) merge public repo

* chore(*) merge public repo (#219)

* feat(docs): 0.35 Release Base

* docs(35): Bump EE Latest Version (#232)

* update travis node version

* docs(35) navigation (#231)

* feat(nav): Adds 3 level navigation (#233)

* docs(35/deployment) copy licensing section (#220)

* Docs/35 nav (#235)

* docs(35) navigation updates

* docs(35): Dev Portal Init

* docs(35/deployment) (#238)

* docs(35/docker) (#222)

* docs(35/centos) (#223)

* docs(35/amazon-linux) (#224)

* fix 35 nav formatting

* docs(nav) remove duplicate sections

* docs(35/km/overview) copy old overview

* docs(35/km/overview) replace start with networking

* docs(35/km/overview) clarify section

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) move workspaces above rbac

* refactor(35/km/overview) fix new lines

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) admins rewording

* docs(35/km/overview) networking button rewording

* docs(35/km/overview) reword workspaces

* fix(35): Add index.md

* fix(35): Update Admin API Nav (#244)

* fix(35): Update Admin API Nav

* feat(docs): 35 Index Page Init (#246)

* Docs/35 dev portal config (#247)

* docs(dev-portal): Auth types

* Docs/35 dev portal config (#248)

* add warning to basic auth

* add workspaces

* docs(35): Audit Log (#249)

* docs(35): Vitals (#239)

* docs(35): Dev Portal Networking Ref (#243)

* docs(35): Property Reference  (#251)

* docs(35/manager) Kong Manager TD-121 (#245)

For RC only

* docs(35)/dev-portal (#236)

* Docs/35 temp plugins (#252)

* Revert "docs(35)/dev-portal (#236)" (#253)

This reverts commit 0d9c2afad73734443ea73d367c15ef0da06e5c87.

* Docs/35 dev portal temp (#255)

* Docs/getting started temp (#257)

* docs(35/prop-ref) correct name of prop

* docs(35) Admin API (#258)

* docs(35) administration (#259)

* docs(35) remove ad from nav

* docs(35) update admin

* docs(35) reposition nav (#260)

* docs(35) navigation improvements and fixes (#261)

* docs(35) refine getting started (#262)

* docs(35/admin) update reference docs (#263)

* alter nav for rc (#264)

* docs(35/km/auth/oidc) close bracket

Thank you, @Jlawlzz .

* docs(35/admin-api) add examples and corrections (#265)

* fix(35) add items to navigation (#266)

* fix(35/nav) remove typo in nav

* docs(35/admin/example) MVP walkthrough (#267)

* docs(35) start securing km section

* docs(35/getting-started) feedback corrections

* docs(35/admins/ref) add missing attributes (#269)

* docs(35/*) provide security documentation (#270)

* docs(35/km/oidc) improve OIDC (#271)

* docs(35/start) add a note that only one super admin may be seeded

* docs(35) add warning about samesite (#273)

* docs(35/admins/ref) add generate_register_url description INTF-1506 (#272)

Review in staging.

* docs(35/plugin/session) add session doc (#275)

* fix(35/plugin/session) fix template type

* docs(35/getting-started) improve getting started intro (#274)

* docs(ldap-auth-advanced) change property name from ssl to ldaps (#268)

* docs(35/admin-api) update workspaces and rbac responses (#276)

* docs(35/rbac/api) update endpoint permission responses

* docs(35/rbac) permissions endpoints update

* docs(index): Update index grid (#278)

* docs(index): Update index grid

* docs(docker): Update installation commands (#277)

* docs(docker): Update installation commands

* docs(35): Add plugin redirects (#250)

* docs(35): Add plugin redirects

* Docs/35 plugins (#280)

* add redirects for jwt and rbh

* init dev portal files

* docs(35/*) session config and disclaimer (#283)

* Adds details to session configuration
* All places that suggest setting `enforce_rbac = on` now mention `admin_gui_session_conf`
* Adds a disclaimer to any example pertaining to `secret`, `cookie_secure`, and `cookie_samesite`
* All entry points (i.e. places that suggest setting `admin_gui_session_conf`) link to Kong Manager Session doc, which in turn links to Session Plugin after distinguishing the 2
* Clear statement that Session Plugin is required with any auth type
* General stylistic cleanup around the Session page titles

* docs(getting-started): Add grid overview (#282)

* hotfix(35/session) fix yml format

* add managing developers

* update nav for internal preview

* docs(vault-auth) add 0.1-x vault-auth docs (#216)

* docs(vault-auth) add 0.1-x vault-auth docs

* add dev portal docs

* add overview to getting started

* docs(35/km/ws) add note about admins without roles having "access" - EBB 90 (#281)

* docs(35/nav) remove install overview

* docs(35/nav) move down overview to distinct section

* docs(35/nav) flatten nav for upgrades

* docs(35/*) add migration guide

* docs(35/nav) remove aws guide link until update is ready

* hotfix(35/migrations) fix link

* hotfix(35/migrations) fix links

* docs(35/migrations) style the 'important' block

* docs(35/migrations) make external links open new windows

* docs(35/amazon-linux) fix migrations option

* docs(35/docker) fix migrations option

* docs(35/install) hide unused guides

* docs(35/*) fix config link

* fix(35/start) fix link

* fix(35/start) fix link

* fix(35/*) getting started links

* docs(35/*) add security sec

* dev portal updates

* Chore/public merge (#286)

- merge public repo

* fix merge conflicts

* merge public repo

* Release/0.35 3 (#294)

* docs(rate-limiting-advanced) add configuration parameter for redis cluster

* write(35/km) how to reset password and rbac token (#287)

* write(35/km) how to reset password and rbac token

* change hard links to header links

* fix bold formatted words

* fix list numbering

* change hard links to dynamic

* add page to navigation

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

Co-Authored-By: levi <[email protected]>

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* docs(enterprise/migrations) migrate-apis CLI guide (#289)

* chore(properties) add description fro db_cache_warmup_entities configuration (#290)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release (#291)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release

* apply suggestions from code review

* Add cli.md to enterprise doc tree (#292)

* chore(cli) duplicate core cli doc and add new enterprise migrations commands

* chore(nav) update nav to pick up new cli file

* copy updates

* changelog formatting

Adds references to API migration guide to 0.35 migration guide

* remove extra line

* Add Upstream TLS to Hub (#295)

* Add Upstream TLS to Hub

* Add to nav

* Clearer explanation for known issue

* Delete adding-your-api.md

* Delete adding-your-api.md

* Delete best-practices.md

* Delete index.md

* Delete disabling-auth.md

* Delete aws-cloudfront.md

* Delete index.md

* Delete admins.md

* Delete quickstart.md

* Delete google-cloud.md

* Delete route-by-headers.md

* Delete understanding-page-routing.md

* Update macos.md

* Update autodoc-admin-api/run.lua

* Update autodoc-admin-api/run.lua

* Delete package-lock.json

* fix package-lock

* package-lock

* docs(cli-ref) fix link to conf ref (#1412)

Updates link to Enterprise-version; currently 404s.

* fix cli link typo

* Docs/35 install ubuntu (#1396)

* init ubuntu 35 doc

* doc(installation): Add 0.35 Ubuntu doc

* Update app/enterprise/0.35-x/deployment/installation/ubuntu.md

* Update acl/index.md (#1411)

declarative config for acls expects array

* fix egregious broken links while at it

* package log merge conflicts

* 0.36 Release (#297)

* Dup 35 to 36

* docks(plugins/request-validator) guide for new configs (#301)

* docks(plugins/request-validator) guide for new configs

* docs(mtls-auth) initial documentation (#285)

* docs(mtls-auth): documentation

* docs(rate-limiting-advanced) add 0.36 changes (#300)

* docs(rate-limiting-advanced) add 0.36 changes

- Add global rate limits by service. If plugin is applied globally, it will have a different counter per service, all with the same rate limit. If plugin is applied per service, then it can be configured on each service.

- Add rate limits by arbitrary headers. The user defines a `config.identifier.header` identifier and also a `config.header_name` name to set up rate limiting by any given header name.

* 0.36 OAuth2 Introspection Plugin Update (#299)

* 0.36 updates

* implement gszr's suggestion

* Docs/0.36 changelog (#298)

* 0.36 Changelog

* update migrations CLI guide (#302)

- change 0.34 to 0.35

* update plugins for 0.36 (#303)

* update plugins for 0.36

* update migration guide link

* remove migration guide links

* Chore/public merge (#305)

- merge public repo

* docs(upstream-tls) curl option correction (#309)

Original: --data
Fix: --form

### Summary
The original document uses `--data` for submitting the certificates, which will actually result in a schema violation. Using `--form` instead help address the issue.

### Full changelog

* [app/_hub/kong-inc/upstream-tls/0.35-x.md]: curl option correction

* docs(upstream-tls) curl option correction (#308)

Original: --data
Fix: --form

### Summary
The original document uses `--data` for submitting the certificates, which will actually result in a schema violation. Using `--form` instead help address the issue.

### Full changelog

* [app/_hub/kong-inc/upstream-tls/index.md]: curl option correction

* Release/0.36 (#310)

* chore(proxy-cache) add redis cluster_addresses parameter (#307)

* chore(merge) reflect changes made to public 36

* chore(changelog) - add 0.35-4 and 0.36-1 (#311)

* chore(changelog) - add 0.35-4 and 0.36-1

* remove empty sections

* link CVEs

* docs(changelog) release changelog (#313)

* docs(changelog) release changelog

* chore(changelog) remove descitpion for plugin that was not added

* chore(changelog) - fix typo

* chore(changelog) - add entry for custom_id on developers

* chore(0.37): copy 0.36

* merge public repo

* Chore/public merge 0.37 (#315)

* Update dependency lodash to v4.17.13 [SECURITY] (#1395)

* docs(add-plugin) delete unused page (#1400)

Topic covered in enable-plugin.

* add custom plugin apig-response-transform (#1365)

* Release/0.35-3 (#1406)

* chore(ee/changelog) release 0.34-1 FT-358 (#210)

* docs(ee/changelog) 0.34-1 release

* chore(ee/changelog) remove trailing whitespace

* docs(openid-connect) updated doc to 2.7.0 version

* docs(edits) copy and style edits

* chore(*) merge public repo (#211)

* chore(*) merge public repo

* chore(*) merge public repo (#219)

* feat(docs): 0.35 Release Base

* docs(35): Bump EE Latest Version (#232)

* update travis node version

* docs(35) navigation (#231)

* feat(nav): Adds 3 level navigation (#233)

* docs(35/deployment) copy licensing section (#220)

* Docs/35 nav (#235)

* docs(35) navigation updates

* docs(35): Dev Portal Init

* docs(35/deployment) (#238)

* docs(35/docker) (#222)

* docs(35/centos) (#223)

* docs(35/amazon-linux) (#224)

* fix 35 nav formatting

* docs(nav) remove duplicate sections

* docs(35/km/overview) copy old overview

* docs(35/km/overview) replace start with networking

* docs(35/km/overview) clarify section

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) move workspaces above rbac

* refactor(35/km/overview) fix new lines

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) admins rewording

* docs(35/km/overview) networking button rewording

* docs(35/km/overview) reword workspaces

* fix(35): Add index.md

* fix(35): Update Admin API Nav (#244)

* fix(35): Update Admin API Nav

* feat(docs): 35 Index Page Init (#246)

* Docs/35 dev portal config (#247)

* docs(dev-portal): Auth types

* Docs/35 dev portal config (#248)

* add warning to basic auth

* add workspaces

* docs(35): Audit Log (#249)

* docs(35): Vitals (#239)

* docs(35): Dev Portal Networking Ref (#243)

* docs(35): Property Reference  (#251)

* docs(35/manager) Kong Manager TD-121 (#245)

For RC only

* docs(35)/dev-portal (#236)

* Docs/35 temp plugins (#252)

* Revert "docs(35)/dev-portal (#236)" (#253)

This reverts commit 0d9c2afad73734443ea73d367c15ef0da06e5c87.

* Docs/35 dev portal temp (#255)

* Docs/getting started temp (#257)

* docs(35/prop-ref) correct name of prop

* docs(35) Admin API (#258)

* docs(35) administration (#259)

* docs(35) remove ad from nav

* docs(35) update admin

* docs(35) reposition nav (#260)

* docs(35) navigation improvements and fixes (#261)

* docs(35) refine getting started (#262)

* docs(35/admin) update reference docs (#263)

* alter nav for rc (#264)

* docs(35/km/auth/oidc) close bracket

Thank you, @Jlawlzz .

* docs(35/admin-api) add examples and corrections (#265)

* fix(35) add items to navigation (#266)

* fix(35/nav) remove typo in nav

* docs(35/admin/example) MVP walkthrough (#267)

* docs(35) start securing km section

* docs(35/getting-started) feedback corrections

* docs(35/admins/ref) add missing attributes (#269)

* docs(35/*) provide security documentation (#270)

* docs(35/km/oidc) improve OIDC (#271)

* docs(35/start) add a note that only one super admin may be seeded

* docs(35) add warning about samesite (#273)

* docs(35/admins/ref) add generate_register_url description INTF-1506 (#272)

Review in staging.

* docs(35/plugin/session) add session doc (#275)

* fix(35/plugin/session) fix template type

* docs(35/getting-started) improve getting started intro (#274)

* docs(ldap-auth-advanced) change property name from ssl to ldaps (#268)

* docs(35/admin-api) update workspaces and rbac responses (#276)

* docs(35/rbac/api) update endpoint permission responses

* docs(35/rbac) permissions endpoints update

* docs(index): Update index grid (#278)

* docs(index): Update index grid

* docs(docker): Update installation commands (#277)

* docs(docker): Update installation commands

* docs(35): Add plugin redirects (#250)

* docs(35): Add plugin redirects

* Docs/35 plugins (#280)

* add redirects for jwt and rbh

* init dev portal files

* docs(35/*) session config and disclaimer (#283)

* Adds details to session configuration
* All places that suggest setting `enforce_rbac = on` now mention `admin_gui_session_conf`
* Adds a disclaimer to any example pertaining to `secret`, `cookie_secure`, and `cookie_samesite`
* All entry points (i.e. places that suggest setting `admin_gui_session_conf`) link to Kong Manager Session doc, which in turn links to Session Plugin after distinguishing the 2
* Clear statement that Session Plugin is required with any auth type
* General stylistic cleanup around the Session page titles

* docs(getting-started): Add grid overview (#282)

* hotfix(35/session) fix yml format

* add managing developers

* update nav for internal preview

* docs(vault-auth) add 0.1-x vault-auth docs (#216)

* docs(vault-auth) add 0.1-x vault-auth docs

* add dev portal docs

* add overview to getting started

* docs(35/km/ws) add note about admins without roles having "access" - EBB 90 (#281)

* docs(35/nav) remove install overview

* docs(35/nav) move down overview to distinct section

* docs(35/nav) flatten nav for upgrades

* docs(35/*) add migration guide

* docs(35/nav) remove aws guide link until update is ready

* hotfix(35/migrations) fix link

* hotfix(35/migrations) fix links

* docs(35/migrations) style the 'important' block

* docs(35/migrations) make external links open new windows

* docs(35/amazon-linux) fix migrations option

* docs(35/docker) fix migrations option

* docs(35/install) hide unused guides

* docs(35/*) fix config link

* fix(35/start) fix link

* fix(35/start) fix link

* fix(35/*) getting started links

* docs(35/*) add security sec

* dev portal updates

* Chore/public merge (#286)

- merge public repo

* fix merge conflicts

* merge public repo

* Release/0.35 3 (#294)

* docs(rate-limiting-advanced) add configuration parameter for redis cluster

* write(35/km) how to reset password and rbac token (#287)

* write(35/km) how to reset password and rbac token

* change hard links to header links

* fix bold formatted words

* fix list numbering

* change hard links to dynamic

* add page to navigation

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

Co-Authored-By: levi <[email protected]>

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* docs(enterprise/migrations) migrate-apis CLI guide (#289)

* chore(properties) add description fro db_cache_warmup_entities configuration (#290)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release (#291)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release

* apply suggestions from code review

* Add cli.md to enterprise doc tree (#292)

* chore(cli) duplicate core cli doc and add new enterprise migrations commands

* chore(nav) update nav to pick up new cli file

* copy updates

* changelog formatting

Adds references to API migration guide to 0.35 migration guide

* remove extra line

* Add Upstream TLS to Hub (#295)

* Add Upstream TLS to Hub

* Add to nav

* Clearer explanation for known issue

* Delete adding-your-api.md

* Delete adding-your-api.md

* Delete best-practices.md

* Delete index.md

* Delete disabling-auth.md

* Delete aws-cloudfront.md

* Delete index.md

* Delete admins.md

* Delete quickstart.md

* Delete google-cloud.md

* Delete route-by-headers.md

* Delete understanding-page-routing.md

* Update macos.md

* Update autodoc-admin-api/run.lua

* Update autodoc-admin-api/run.lua

* Delete package-lock.json

* fix package-lock

* package-lock

* docs(cli-ref) fix link to conf ref (#1412)

Updates link to Enterprise-version; currently 404s.

* fix cli link typo

* Docs/35 install ubuntu (#1396)

* init ubuntu 35 doc

* doc(installation): Add 0.35 Ubuntu doc

* Update app/enterprise/0.35-x/deployment/installation/ubuntu.md

* Update acl/index.md (#1411)

declarative config for acls expects array

* fix egregious broken links while at it

* docs(pdk) kong.request.get_http_version() returns a number, not a string

Since this has been the case since the first version in the PDK, this change updates thes fields manually (they are usually auto-generated, but the tags for the versions are fixed and can't be changed in order to auto-generate them correctly).

* Revert Plugins to Hub in main site nav

* End of A/B Test

* docs(hub) introduce decK (#1418)

* docs(hub) introduce decK

* fix typos

* add icon

* update decK version compat

* docs(35/km/reset-password) add screenshots (#1413)

* docs(35/km/reset-password) add screenshots

* docs(admin-api) redirect index to ref (#1420)

KM currently links to `/admin-api/admins`. There will eventually be an explanatory doc for this path. For now, it should redirect to the API reference since otherwise it 404s.

* update plugin versions

* 0.36 Release (#1430)

* chore(ee/changelog) release 0.34-1 FT-358 (#210)

* docs(ee/changelog) 0.34-1 release

* chore(ee/changelog) remove trailing whitespace

* docs(openid-connect) updated doc to 2.7.0 version

* docs(edits) copy and style edits

* chore(*) merge public repo (#211)

* chore(*) merge public repo

* chore(*) merge public repo (#219)

* feat(docs): 0.35 Release Base

* docs(35): Bump EE Latest Version (#232)

* update travis node version

* docs(35) navigation (#231)

* feat(nav): Adds 3 level navigation (#233)

* docs(35/deployment) copy licensing section (#220)

* Docs/35 nav (#235)

* docs(35) navigation updates

* docs(35): Dev Portal Init

* docs(35/deployment) (#238)

* docs(35/docker) (#222)

* docs(35/centos) (#223)

* docs(35/amazon-linux) (#224)

* fix 35 nav formatting

* docs(nav) remove duplicate sections

* docs(35/km/overview) copy old overview

* docs(35/km/overview) replace start with networking

* docs(35/km/overview) clarify section

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) move workspaces above rbac

* refactor(35/km/overview) fix new lines

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) admins rewording

* docs(35/km/overview) networking button rewording

* docs(35/km/overview) reword workspaces

* fix(35): Add index.md

* fix(35): Update Admin API Nav (#244)

* fix(35): Update Admin API Nav

* feat(docs): 35 Index Page Init (#246)

* Docs/35 dev portal config (#247)

* docs(dev-portal): Auth types

* Docs/35 dev portal config (#248)

* add warning to basic auth

* add workspaces

* docs(35): Audit Log (#249)

* docs(35): Vitals (#239)

* docs(35): Dev Portal Networking Ref (#243)

* docs(35): Property Reference  (#251)

* docs(35/manager) Kong Manager TD-121 (#245)

For RC only

* docs(35)/dev-portal (#236)

* Docs/35 temp plugins (#252)

* Revert "docs(35)/dev-portal (#236)" (#253)

This reverts commit 0d9c2afad73734443ea73d367c15ef0da06e5c87.

* Docs/35 dev portal temp (#255)

* Docs/getting started temp (#257)

* docs(35/prop-ref) correct name of prop

* docs(35) Admin API (#258)

* docs(35) administration (#259)

* docs(35) remove ad from nav

* docs(35) update admin

* docs(35) reposition nav (#260)

* docs(35) navigation improvements and fixes (#261)

* docs(35) refine getting started (#262)

* docs(35/admin) update reference docs (#263)

* alter nav for rc (#264)

* docs(35/km/auth/oidc) close bracket

Thank you, @Jlawlzz .

* docs(35/admin-api) add examples and corrections (#265)

* fix(35) add items to navigation (#266)

* fix(35/nav) remove typo in nav

* docs(35/admin/example) MVP walkthrough (#267)

* docs(35) start securing km section

* docs(35/getting-started) feedback corrections

* docs(35/admins/ref) add missing attributes (#269)

* docs(35/*) provide security documentation (#270)

* docs(35/km/oidc) improve OIDC (#271)

* docs(35/start) add a note that only one super admin may be seeded

* docs(35) add warning about samesite (#273)

* docs(35/admins/ref) add generate_register_url description INTF-1506 (#272)

Review in staging.

* docs(35/plugin/session) add session doc (#275)

* fix(35/plugin/session) fix template type

* docs(35/getting-started) improve getting started intro (#274)

* docs(ldap-auth-advanced) change property name from ssl to ldaps (#268)

* docs(35/admin-api) update workspaces and rbac responses (#276)

* docs(35/rbac/api) update endpoint permission responses

* docs(35/rbac) permissions endpoints update

* docs(index): Update index grid (#278)

* docs(index): Update index grid

* docs(docker): Update installation commands (#277)

* docs(docker): Update installation commands

* docs(35): Add plugin redirects (#250)

* docs(35): Add plugin redirects

* Docs/35 plugins (#280)

* add redirects for jwt and rbh

* init dev portal files

* docs(35/*) session config and disclaimer (#283)

* Adds details to session configuration
* All places that suggest setting `enforce_rbac = on` now mention `admin_gui_session_conf`
* Adds a disclaimer to any example pertaining to `secret`, `cookie_secure`, and `cookie_samesite`
* All entry points (i.e. places that suggest setting `admin_gui_session_conf`) link to Kong Manager Session doc, which in turn links to Session Plugin after distinguishing the 2
* Clear statement that Session Plugin is required with any auth type
* General stylistic cleanup around the Session page titles

* docs(getting-started): Add grid overview (#282)

* hotfix(35/session) fix yml format

* add managing developers

* update nav for internal preview

* docs(vault-auth) add 0.1-x vault-auth docs (#216)

* docs(vault-auth) add 0.1-x vault-auth docs

* add dev portal docs

* add overview to getting started

* docs(35/km/ws) add note about admins without roles having "access" - EBB 90 (#281)

* docs(35/nav) remove install overview

* docs(35/nav) move down overview to distinct section

* docs(35/nav) flatten nav for upgrades

* docs(35/*) add migration guide

* docs(35/nav) remove aws guide link until update is ready

* hotfix(35/migrations) fix link

* hotfix(35/migrations) fix links

* docs(35/migrations) style the 'important' block

* docs(35/migrations) make external links open new windows

* docs(35/amazon-linux) fix migrations option

* docs(35/docker) fix migrations option

* docs(35/install) hide unused guides

* docs(35/*) fix config link

* fix(35/start) fix link

* fix(35/start) fix link

* fix(35/*) getting started links

* docs(35/*) add security sec

* dev portal updates

* Chore/public merge (#286)

- merge public repo

* fix merge conflicts

* merge public repo

* Release/0.35 3 (#294)

* docs(rate-limiting-advanced) add configuration parameter for redis cluster

* write(35/km) how to reset password and rbac token (#287)

* write(35/km) how to reset password and rbac token

* change hard links to header links

* fix bold formatted words

* fix list numbering

* change hard links to dynamic

* add page to navigation

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

Co-Authored-By: levi <[email protected]>

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* docs(enterprise/migrations) migrate-apis CLI guide (#289)

* chore(properties) add description fro db_cache_warmup_entities configuration (#290)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release (#291)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release

* apply suggestions from code review

* Add cli.md to enterprise doc tree (#292)

* chore(cli) duplicate core cli doc and add new enterprise migrations commands

* chore(nav) update nav to pick up new cli file

* copy updates

* changelog formatting

Adds references to API migration guide to 0.35 migration guide

* remove extra line

* Add Upstream TLS to Hub (#295)

* Add Upstream TLS to Hub

* Add to nav

* Clearer explanation for known issue

* Chore/public merge (#296)

* Update dependency lodash to v4.17.13 [SECURITY] (#1395)

* docs(add-plugin) delete unused page (#1400)

Topic covered in enable-plugin.

* add custom plugin apig-response-transform (#1365)

* Release/0.35-3 (#1406)

* chore(ee/changelog) release 0.34-1 FT-358 (#210)

* docs(ee/changelog) 0.34-1 release

* chore(ee/changelog) remove trailing whitespace

* docs(openid-connect) updated doc to 2.7.0 version

* docs(edits) copy and style edits

* chore(*) merge public repo (#211)

* chore(*) merge public repo

* chore(*) merge public repo (#219)

* feat(docs): 0.35 Release Base

* docs(35): Bump EE Latest Version (#232)

* update travis node version

* docs(35) navigation (#231)

* feat(nav): Adds 3 level navigation (#233)

* docs(35/deployment) copy licensing section (#220)

* Docs/35 nav (#235)

* docs(35) navigation updates

* docs(35): Dev Portal Init

* docs(35/deployment) (#238)

* docs(35/docker) (#222)

* docs(35/centos) (#223)

* docs(35/amazon-linux) (#224)

* fix 35 nav formatting

* docs(nav) remove duplicate sections

* docs(35/km/overview) copy old overview

* docs(35/km/overview) replace start with networking

* docs(35/km/overview) clarify section

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) move workspaces above rbac

* refactor(35/km/overview) fix new lines

* docs(35/km/overview) rbac rewording

* docs(35/km/overview) admins rewording

* docs(35/km/overview) networking button rewording

* docs(35/km/overview) reword workspaces

* fix(35): Add index.md

* fix(35): Update Admin API Nav (#244)

* fix(35): Update Admin API Nav

* feat(docs): 35 Index Page Init (#246)

* Docs/35 dev portal config (#247)

* docs(dev-portal): Auth types

* Docs/35 dev portal config (#248)

* add warning to basic auth

* add workspaces

* docs(35): Audit Log (#249)

* docs(35): Vitals (#239)

* docs(35): Dev Portal Networking Ref (#243)

* docs(35): Property Reference  (#251)

* docs(35/manager) Kong Manager TD-121 (#245)

For RC only

* docs(35)/dev-portal (#236)

* Docs/35 temp plugins (#252)

* Revert "docs(35)/dev-portal (#236)" (#253)

This reverts commit 0d9c2afad73734443ea73d367c15ef0da06e5c87.

* Docs/35 dev portal temp (#255)

* Docs/getting started temp (#257)

* docs(35/prop-ref) correct name of prop

* docs(35) Admin API (#258)

* docs(35) administration (#259)

* docs(35) remove ad from nav

* docs(35) update admin

* docs(35) reposition nav (#260)

* docs(35) navigation improvements and fixes (#261)

* docs(35) refine getting started (#262)

* docs(35/admin) update reference docs (#263)

* alter nav for rc (#264)

* docs(35/km/auth/oidc) close bracket

Thank you, @Jlawlzz .

* docs(35/admin-api) add examples and corrections (#265)

* fix(35) add items to navigation (#266)

* fix(35/nav) remove typo in nav

* docs(35/admin/example) MVP walkthrough (#267)

* docs(35) start securing km section

* docs(35/getting-started) feedback corrections

* docs(35/admins/ref) add missing attributes (#269)

* docs(35/*) provide security documentation (#270)

* docs(35/km/oidc) improve OIDC (#271)

* docs(35/start) add a note that only one super admin may be seeded

* docs(35) add warning about samesite (#273)

* docs(35/admins/ref) add generate_register_url description INTF-1506 (#272)

Review in staging.

* docs(35/plugin/session) add session doc (#275)

* fix(35/plugin/session) fix template type

* docs(35/getting-started) improve getting started intro (#274)

* docs(ldap-auth-advanced) change property name from ssl to ldaps (#268)

* docs(35/admin-api) update workspaces and rbac responses (#276)

* docs(35/rbac/api) update endpoint permission responses

* docs(35/rbac) permissions endpoints update

* docs(index): Update index grid (#278)

* docs(index): Update index grid

* docs(docker): Update installation commands (#277)

* docs(docker): Update installation commands

* docs(35): Add plugin redirects (#250)

* docs(35): Add plugin redirects

* Docs/35 plugins (#280)

* add redirects for jwt and rbh

* init dev portal files

* docs(35/*) session config and disclaimer (#283)

* Adds details to session configuration
* All places that suggest setting `enforce_rbac = on` now mention `admin_gui_session_conf`
* Adds a disclaimer to any example pertaining to `secret`, `cookie_secure`, and `cookie_samesite`
* All entry points (i.e. places that suggest setting `admin_gui_session_conf`) link to Kong Manager Session doc, which in turn links to Session Plugin after distinguishing the 2
* Clear statement that Session Plugin is required with any auth type
* General stylistic cleanup around the Session page titles

* docs(getting-started): Add grid overview (#282)

* hotfix(35/session) fix yml format

* add managing developers

* update nav for internal preview

* docs(vault-auth) add 0.1-x vault-auth docs (#216)

* docs(vault-auth) add 0.1-x vault-auth docs

* add dev portal docs

* add overview to getting started

* docs(35/km/ws) add note about admins without roles having "access" - EBB 90 (#281)

* docs(35/nav) remove install overview

* docs(35/nav) move down overview to distinct section

* docs(35/nav) flatten nav for upgrades

* docs(35/*) add migration guide

* docs(35/nav) remove aws guide link until update is ready

* hotfix(35/migrations) fix link

* hotfix(35/migrations) fix links

* docs(35/migrations) style the 'important' block

* docs(35/migrations) make external links open new windows

* docs(35/amazon-linux) fix migrations option

* docs(35/docker) fix migrations option

* docs(35/install) hide unused guides

* docs(35/*) fix config link

* fix(35/start) fix link

* fix(35/start) fix link

* fix(35/*) getting started links

* docs(35/*) add security sec

* dev portal updates

* Chore/public merge (#286)

- merge public repo

* fix merge conflicts

* merge public repo

* Release/0.35 3 (#294)

* docs(rate-limiting-advanced) add configuration parameter for redis cluster

* write(35/km) how to reset password and rbac token (#287)

* write(35/km) how to reset password and rbac token

* change hard links to header links

* fix bold formatted words

* fix list numbering

* change hard links to dynamic

* add page to navigation

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

Co-Authored-By: levi <[email protected]>

* Update app/enterprise/0.35-x/kong-manager/reset-password.md

* docs(enterprise/migrations) migrate-apis CLI guide (#289)

* chore(properties) add description fro db_cache_warmup_entities configuration (#290)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release (#291)

* chore(changelog) add 0.35-1 and 0.35-3 to changelog for this release

* apply suggestions from code review

* Add cli.md to enterprise doc tree (#292)

* chore(cli) duplicate core cli doc and add new enterprise migrations commands

* chore(nav) update nav to pick up new cli file

* copy updates

* changelog formatting

Adds references to API migration guide to 0.35 migration guide

* remove extra line

* Add Upstream TLS to Hub (#295)

* Add Upstream TLS to Hub

* Add to nav

* Clearer explanation for known issue

* Delete adding-your-api.md

* Delete adding-your-api.md

* Delete best-practices.md

* Delete index.md

* Delete disabling-auth.md

* Delete aws-cloudfront.md

* Delete index.md

* Delete admins.md

* Delete quickstart.md

* Delete google-cloud.md

* Delete route-by-headers.md

* Delete understanding-page-routing.md

* Update macos.md

* Update autodoc-admin-api/run.lua

* Update autodoc-admin-api/run.lua

* Delete package-lock.json

* fix package-lock

* package-lock

* docs(cli-ref) fix link to conf ref (#1412)

Updates link to Enterprise-version; currently 404s.

* fix cli link typo

* Docs/35 install ubuntu (#1396)

* init ubuntu 35 doc

* doc(installation): Add 0.35 Ubuntu doc

* Update app/enterprise/0.35-x/deployment/installation/ubuntu.md

* Update acl/index.md (#1411)

declarative config for acls expects array

* fix egregious broken links while at it

* package log merge conflicts

* 0.36 Release (#297)

* Dup 35 to 36

* docks(plugins/request-validator) guide for new configs (#301)

* docks(plugins/request-validator) guide for new configs

* docs(mtls-auth) initial documentation (#285)

* docs(mtls-auth): documentation

* docs(rate-limiting-advanced) add 0.36 changes (#300)

* docs(rate-limiting-advanced) add 0.36 changes

- Add global rate limits by service. If plugin is applied globally, it will have a different counter per service, all with the same rate limit. If plugin is applied per service, then it can be configured on each service.

- Add rate limits by arbitrary headers. The user defines a `config.identifier.header` identifier and also a `config.header_name` name to set up rate limiting by any given header name.

* 0.36 OAuth2 Introspection Plugin Update (#299)

* 0.36 updates

* implement gszr's suggestion

* Docs/0.36 changelog (#298)

* 0.36 Changelog

* update migrations CLI guide (#302)

- change 0.34 to 0.35

* update plugins for 0.36 (#303)

* update plugins for 0.36

* update migration guide link

* remove migration guide links

* Chore/public merge (#305)

- merge public repo

* Update changelog.md

* Remove duplicate parameter (#1428)

* Remove duplicate parameter

* Update main nav verbiage from Hub to Plugins

* Update based on outcome of recent A/B test

* algolia test

* docs(1.x.x/upgrading) fix copy-n-paste error from previous version (#1435)

* docs(1.x.x/upgrading) fix copy-n-paste error from previous version

* Update app/1.1.x/upgrading.md

* algolia ee index

* docs(36) update migrations guide

* docs(changelog) update 36 changes

* docs(1.1.x) update upgrading.md file for Kong 1.1

This change basically involves replacing most of the text on this
page with the relevant section in
https://github.com/Kong/kong/blob/master/UPGRADE.md.

There are two deviations from that:

* Modified some header levels
* The section `Upgrade Path for Patch Releases` did not exist
  in the `UPGRADE.md` document - I left that part, since there's a
  1.1.0 release and a 1.1.1 release.

* docs(1.2.x) update upgrading.md file for Kong 1.2

This change basically involves replacing most of the text on this
page with the relevant section in
https://github.com/Kong/kong/blob/master/UPGRADE.md.

There are two major deviations from that file:
* I changed several header levels
* The `Upgrade Path for Patch Releases` section does not exist in
  UPGRADE.md, but I have left it here.

* update 0.35 CLI entity migration guide (#1429)

* update 0.35 CLI entity migration guide

* Update app/enterprise/0.35-x/deployment/migrate-apis-cli.md

* fix broken link (#1441)

* Update dependency rouge to v3.8.0 (#1374)

* Add EE compatibility (#1439)

* add missing images (#1443)

* Tag Response Transformer Advanced as Enterprise Plugin (#1438)

* Remove duplicate parameter

Closes Issue #1422

* add newline

* Change to Enterprise Plugin

* update 0.35

* add reference folder (#1440)

* style(*) remove enterprise header styling (#1445)

* Chore/merge private repo (#1446)

- upstream tls

* docs(oidc) update from APIs to Services & Routes (#1404)

* docs(oidc) update from APIs to Services / Routes

* remove leftover closing bracket

* make the step title less threatening

* fix indentation and add closing bracket to sample

* clarify sentence about redirection to URI

* fix case typo

* apply services/routes to previous versions

* Update Canary Release Plugin docs (#1444)

* add missing params

* fix config typos

* Update usage

* add newline

* add newline

* updated old "api" based docs to "service/route" based (#1447)

* updated old "api" based docs to "service/route" based

* additional update

* SG/style updates

* chore(*) update release metadata for 1.2.2 (#1450)

* docs(36-ee/1.2-ce) copy core material  (#1455)

* copy over unique 36 files

* remove leftover reference to db-less

* move configuration loading to prop ref

* add guides to nav

* admin api merge

* remove core upgrade guide

* remove unneeded note

* redirect to prop ref

* change link to ent version in oidc

* replace core with enterprise path

* replace core with enterprise path

* change config to prop ref link

* fix hub 404

* repeat corrections from 0.35

* docs(35-ee/1.0-ce) copy core material  (#1454)

* copy over files from 1.0

* move configuration loading section

* add new navigation

* change links to enterprise version

* remove trailing space

* provide base links

* fix broken nav link

* fix similar issues to 34

* fix links

* add mention of enterprise

* remove reference to core guide

* docs(34-ee/13-ce) copy core material (#1453)

* add enterprise cluster ref

* add enterprise config ref

* link dev portal to enterprise guide instead

* new navigation

* add core admin api

* add auth reference

* add cli reference

* update links in clustering

* update links in deployment

* add health checks circuit breakers

* update links in architecture patterns

* add loadbalancing and netwroking

* update links in oidc idp guides

* add configuration loading section

* add proxy and secure admin api pages

* update link to prop ref

* update links in getting started guides

* update links in getting started guides

* update link in amazon linux guide

* update link in kong manager getting started

* add lua reference

* add plugin development

* update links in ee-exclusive admin api ref

* fix links

* ensure Enterprise / EE is mentioned

* Update .travis.yml (#1459)

* docs(enterprise/*) fix typo on deployment page (#1462)

* Update index.md

* Update index.md

* Yolo.

* docs(1.3.x) add 1.3.0 docs (#1415)

* docs(1.3.x) add 1.3.x pages as copies of 1.2.x

* chore(1.3.x) update supported kong versions in plugins

* docs(*) add description to admin api related dao schema parameters

Describes following properties:
- `generate_admin_api`
- `admin_api_name`
- `admin_api_nested_name`

Co-Authored-By: Enrique García Cota <[email protected]>

* docs(1.3.x) document Route.headers function in proxying

* docs(grpc) add grpc/grpcs to protocols in plugins

To all of the plugins that support gRPC in Kong 1.3.0.

* docs(getting-started) add grpc guide

* docs(proxy) update proxy guide

- Add grpc
- Describe subsystems routing attributes
- Add section for `sources`, `destinations`, and `snis`

* docs(proxy) add more description text for SNI matcher in Route entity (#1442)


Co-Authored-By: Guilherme Salazar <[email protected]>

* docs(1.3.x) add upgrading.md instructions for 1.3.x (#1437)

Most changes from this commit are a straight replacement of the
text using https://github.com/Kong/kong/blob/next/UPGRADE.md .

There are two notable exceptions:

* Header levels have been changed
* The `Upgrade Path for Patch Releases` section does not exist in
  Kong's `UPGRADE.md` file.

* docs(key-auth) remove the underscore in key name restriction from doc
because it no longer applies

* docs(pdk) update PDK docs for 1.3.0

* docs(1.3.0) refresh auto-generated Admin API docs

* docs(1.3.0) refresh auto-generated CLI docs

* docs(1.3.0) refresh auto-generated config file docs

* chore(1.3.0) add entry in kong_versions.yml

* fix(yml-version) add hyphen

* feat(install) prepare for multi-arch releases (#1427)

* Update changelog.md (#1458)

* Feat/redirect broken urls (#1463)

* update redirects

* adding redirects

- redirect broken/404’d URLs
- create files where necessary to utilize redirect_to

* docs(oidc) Update Dev Portal OIDC configuration and text (#1466)

* docs(oidc) Update Dev Portal OIDC configuration and text

* Update app/enterprise/0.35-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/enterprise/0.35-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/enterprise/0.35-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/enterprise/0.36-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/enterprise/0.36-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/enterprise/0.36-x/developer-portal/configuration/authentication/oidc.md

Co-Authored-By: Aron Eidelman <[email protected]>

* chore(ee/*) remove leftover front matter (#1471)

* chore(ee/*) remove leftover frontmatter

* Update index.md

* Add Certificate Authority documenation (#1467)

* docs(hub) add CA certificate creation to mTLS docs

Add instructions on creating CA certificates to the mTLS plugin
documentation, as creating CA certificates is required to use mTLS.

* docs(admin) add CAs to Admin API

Add Certificate Authorities to the admin API documentation. No
equivalent for core as mTLS (the only current use case for Certificate
Authorities) is not available in core.

Additionally fix a rendering error in the 0.35 document.

* fix(admin) remove extra admin API document.

app/enterprise/0.35-x/admin-api.md appears to have been superseded by
app/enterprise/0.35-x/admin-api/index.md. Later versions' doc trees only
have the latter variant. Deleting it as such.

* fix(admin) remove accidentally repeated word

* docs(oidc) add Okta example (#1464)

* docs(oidc) add Okta example

* docs(oidc) add link to Kong Manager Plugin

* docs(oidc) remove duplicate file and cleanup

* docs(oidc) fix spelling and grammar for Okta

* docs(oidc) use sub for Okta consumer_claim

Change the consumer_claim from oid to sub for Okta. The original source
for this doc was the Azure guide, but Azure is the odd IDP out whose sub
claim values can't easily be used with our OIDC implementation, since
there's no way to know the correct value in advance of a sign-in
attempt.

* docs(oidc) add Azure AD example (#1460)

* docs(oidc) add Azure AD example

* fix(oidc) add missing "not" to Azure AD docs

* docs(oidc) link to Manager plugin instructions

* fix(oidc) restore Azure v2 issuer URL example

* Feat/redirection continued (#1465)

* update redirects

* adding redirects

- redirect broken/404’d URLs
- create files where necessary to utilize redirect_to

* updaet redirects

* Update known issues information - FTI-821 (#1448)

* Update known issues information

Remove limitation around bundles and add known issue for PATCHing  trusted_certificates.

* chore(*) make grammatical fix

* Update app/_hub/kong-inc/upstream-tls/index.md

Co-Authored-By: levi <[email protected]>

* Update dependency redcarpet to v3.5.0 (#1426)

* Fix/redirect fix (#1472)

* adding redirects

- redirect broken/404’d URLs
- create files where necessary to utilize redirect_to

* Update a handful of still broken redirects

* 7 total redirects updated to reflect urls provided by Ahmad

* remove broken API reference redirect

* fix early closed front matter

* fix(passwords) use anchor links for page sections (#1474)

* fix(passwords) use anchor links for page sections

Fix Kong Manager password/token reset instructions to point to appropriate anchors within the page, rather than non-existent off-page links.

* apply same fix to 0.35 docs

* fix(proxy) describe actual router rule order (#1473)

Fix proxy router rule evaluation order documentation for newer versions.
The router has evaluated regex path rules before prefix path rules for
some time, and documentation has always stated the reverse. This applies
to older versions also, but has not been updated there for the sake of
time.

Add some additional example information for route shadowing.

Correct broken anchor link.

Made some minor phrasing changes.

* Update portal property reference (#1475)

* Update portal property reference

Add details for portal_email_verification

* Update app/enterprise/0.36-x/property-reference.md

Co-Authored-By: Aron Eidelman <[email protected]>

* docs(ee/changelog) merge 0.36-2 changelog

* chore(merge) merge from private repo

docs(workspaces) update PUT limitation (#312)

* Update dependency del to v5 (#1387)

* Update dependency gulp-load-plugins to v2 (#1388)

* Update dependency lodash to v4.17.15 (#1407)

* rollback renovate updates

* docs(ke/changelog)  (#1478)

* remove links to 1.2.1

* format cve list

* add core features from 1.1.0-1.2.1

* add config features from 1.1.0-1.2.1

* delete DB-less and DC mention from config feats

* delete core link from config feats

* add admin api features from 1.1.0-1.2.1

* add pdk features from 1.1.0-1.2.1

* add plugin features from 1.1.0-1.2.1

* add cli features from 1.1.0-1.2.1

* add core fixes from 1.1.0-1.2.1

* add admin api fixes from 1.1.0-1.2.1

* add plugins fixes from 1.1.0-1.2.1

* add cli fixes from 1.1.0-1.2.1

* format 0.36-1 and -2

* fix typo

* remove references to declarative config

* remove purifycss (#1480)

* Update dependency gulp-if to v3 (#1408)

* Update jekyll/jekyll Docker tag to v3.8.6 (#1409)

* change sass variable to less

* Update dependency rouge to v3.10.0 (#1468)

* update gemfile

* docs(oidc-okta) add Okta configuration steps and images (#1479)

* docs(oidc-okta) add Okta configuration steps and images

* Apply suggestions from code review

Co-Authored-By: Aron Eidelman <[email protected]>

* remove redirect_from for local files

* docs(oas-config) document oas-config Admin API endpoint (#1484)

* docs(oas-config) document oas-config Admin API endpoint

* docs(oas-config) alter messaging for current limitations

* docs(oas-config) markdown for link (#1485)

* docs(oas-config) markdown for link

* Update app/enterprise/0.36-x/oasconfig.md

Co-Authored-By: Aron Eidelman <[email protected]>

* docs(readme) fix-bundler-version (#1477)

* docs(readme) fix-bundler-version

* added upper version for bundler

* docs(readme) fix-typo

* Fixed a typo in the deploying section of README.md

* chore(repo): Upgrades to gulp 4.0.0 (#1482)

* chore(repo): Upgrades to gulp 4.0, removes yarn

Updates all outdated npm packages besides bootstrap, removes yarn, and migrates gulpfile to 4.0.0 syntax

* remove extra dev dependencies

* docs(zipkin) add docs for include_credential config option (#1414)

Tied to https://github.com/Kong/kong-plugin-zipkin/pull/37

* chore(deps): update dependency standard to v14.2.0 (#1470)

* chore(deps): update dependency cloudflare to v2.6.0 (#1417)

* docs(zipkin) add `default_service_name` configuration parameter to docs (#1451)

The default service name can be used to override the
unknown-service-name spans.

* Update Kubernetes Documentation (#1486)

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Update kubernetes.md

* Fixes for PR Feedback

* docs(ee/vitals) add docker link, note for exporter count and remove API rules (#1488)

* docs(ee/vitals) add docker link, note for exporter count and remove API
rules

- Add the link of private fork StatsD exporter docker image
- Add note to match statsd exporters count to Kong nodes
- Remove API related mapping in sample rules

* Update app/enterprise/0.36-x/admin-api/vitals/vitals-prometheus-strategy.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Readd --statsd.listen-unixgram=''

* also add for 0.34 and 0.35

* ci(check links) check for broken links (#1342)

* chore(ci) setup a link-checker to run via travis-ci

* fix(ci) debug why this doesn't work on travis-ci

* fix(ci) adjust travis-ci permissions

* chore(ci) travis-c permissions

* chore(dependency) add the broken link checker dependency

* merge master

* add broken link checker

* Add check-link test to README

* remove docker-test

* Delete .env

* update travis.yml

* update travis.yml

* remove check-link command

* feat(jekyll): Speed up local builds (#1489)

Creates dev only gulp tasks and config files to speed up local build and watch times

* chore(deps): update dependency standard to v14.3.0 (#1487)

* Update custom-entities.md (#1491)

Correct Migration file example `postgres`

* docs(1.3.x/admin-api) fix Routes header example (#1493)

* Update custom-entities.md (#1490)

* Update custom-entities.md

Remove extra brackets and commas

* Update custom-entities.md

* Fix/gulp jekyll dev (#1494)

* oidc template outline

* add jekyll metadata file

* Delete oidc.html

* rewind oidc page

* merge public repo

* 0.37 release prep

* add metadata for faster development

* docs(config) add unescaped character warning (#319)

* docs(changelog/1.3) add all core changes

* docs(*) change version to 1.3-α

* docs(*) update versioning

* docs(changelog) add enterprise features

* docs(37/*) how to add RBAC users in Kong Manager (#322)

* docs(37/km/rbac) add rbac users in km

* docs(37/nav) add rbac user to nav

* docs(1.3/rbac-users) add table of contents

* Update app/enterprise/0.37-x/kong-manager/administration/rbac/add-user.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Reformat steps

* docs(37/config) update configuration reference for summit (#320)

* docs(37/config) 

Add new suffixes to `proxy_listen`.

Remove the future tense ("will" + verb) for style and consistency.

* docs(37/config) update stream_listen

* docs(37/config) polish

* docs(37/config) polish

* docs(37/config) update upstream_keepalive

* docs(37/config) remove upstream keepalive

* docs(37/config) add nginx injected directives

* docs(37/config) add portal_is_legacy

* docs(37/config) add portal_email_verification 

This may have been missing in an earlier release

* docs(37/config) add note to tracing_debug_header

* docs(37/config) add route collision section

* docs(gql-proxy-cache) add documentation for gql-proxy-cache plugin (#321)

* docs(gql-proxy-cache) add documentation for gql-proxy-cache plugin

* add enterprise banner and icon

* update algolia and index

* update algolia index

* Update index.md

* rename to 1.3-x

* doc(serverless) fix sample code (#331)

Fix the example shown in the docs by wrapping the code in a
lambda. This particular code fails without the wrapping because kong
runs the authentication code in the same configuration request.

* add missing x (#345)

* fix broken links

* Update workspaces.md

* Update workspaces.md

* Update reset-password.md

* Update audit-log.md

* Create route-transformer-advanced.md

* Add proxy cache advanced (resolve proxy-cache) (#330)

* docs(37/plugins) add proxy-cache-advanced

* Add proxy-cache-advanced plugin
* Remove redis mentions on proxy-cache

* Update app/_hub/kong-inc/proxy-cache/index.md

* update free trial guide (#351)

* change from EE to advanced

* change organization to teams

* add admins and users

* add new images

* Update app/free-trial/guide/index.html

* add new core and enterprise gateway changes

* finish draft of changelog

* add db-export

* expand admin api toc

* Create configuring-a-grpc-service.md

* enterprise-ify links and names

* docs(plugins/request-transformer) new config 'whitelist' (#324)

* docs(plugins/request-transformer) new config 'whitelist'

* Update app/_hub/kong-inc/request-transformer-advanced/index.md

Co-Authored-By: Lluis Esquerda <[email protected]>

* Update app/_hub/kong-inc/request-transformer-advanced/index.md

Co-Authored-By: Aron Eidelman <[email protected]>

* Update app/_hub/kong-inc/request-transformer-advanced/index.md

* Update app/_hub/kong-inc/request-transformer-advanced/index.md

* docs(plugins/response-transformer) new congif 'whitelist' (#325)

* docs(plugins/response-transformer) new congif 'whitelist'

* docs(plugins/response-transformer) s/paramters/parameters

* doc(plugins/response-transformer) add docs for transform.functions

* Apply suggestions from code review

Co-Authored-By: Aron Eidelman <[email protected]>

* remove alpha mention from changelog

* remove API-only for plugins

* fix headings in changelog

* update Dev Portal changes

* Update README.md

* add note about service mesh removal

* remove broken link

* redirect to different proxy doc

* add core admin api reference

* add missing core doc pages

* add missing pdk and plugin guide

* Release/0.37 devportal (#335)

* add portal_email_verification conf

* style(nav) properly indent portal nav config yml (#336)

* rename to 1.3-x

* feat(portal) DX-799 portal permissions  (#338)

* feat(portal) add portal Administration index.md

* feat(portal) add Portal Roles and Permissions Page

* feat(portal) add sidebar link for portal roles and permissions page

* feat(portal) add portal permissions item to Portal Administration index

* feat(portal) update link for Portal Administraion in Portal Introduction page

* feat(portal) add link to Portal Permissions page from Auth pages

* move to 1.3-x

* feat(portal) update portal permissions docs to include settings.txt and dashboard.txt default roles (#340)

* add portal_auth_password_complexity

* add portal_auth_login_attempts

* Easy Theming

* easy themes

* merge release/0.37

* dev portal

* add editor page

* add cli

* update permissions url

* docs(graphql) 2 new graphql plugins (#341)

* docs(graphql-rate-limiting-advanced) add graphql rate limiting plugin

* docs(degraphql) add degraphql plugin

* Update graphql-rate-limiting-advanced.md

* Update index.md

* chore(plugin) move gql-rate-limiting to right version

* chore(plugin/gql-proxy-cache) rename gql-proxy-cache

* chore(plugins…

algolia/config-studio.json

@@ -0,0 +1,41 @@
+{
+  "index_name": "prod_Studio",
+  "start_urls": [
+    {
+      "url": "https://docs.konghq.com/studio/(?P<version>.*?)/",
+      "variables": {
+        "version": {
+          "url": "https://docs.konghq.com/studio/",
+          "js": "var versions = $('ul[aria-labelledby=version-dropdown] a, button#version-dropdown').map(function(i, e) { return $(e).text().replace(/\\s+/g, '').replace(/Version/g, '').replace(/\\(latest\\)/g, ''); }).toArray(); return JSON.stringify(versions);"
+        }
+      }
+    }
+  ],
+  "sitemap_urls": [
+    "https://docs.konghq.com/sitemap.xml"
+  ],
+  "stop_urls": [
+
+  ],
+  "selectors": {
+    "lvl0": {
+      "selector": ".docs-navigation > a.active",
+      "global": true,
+      "default_value": "Kong Studio"
+    },
+    "lvl1": ".content h1",
+    "lvl2": ".content h2",
+    "lvl3": ".content h3",
+    "lvl4": ".content h4",
+    "text": ".content p, .content li"
+  },
+  "selectors_exclude": [
+    "#next-steps",
+    "#next-steps ~ p"
+  ],
+  "only_content_level": true,
+  "conversation_id": [
+    "534091583"
+  ],
+  "nb_hits": 18645
+}

app/_assets/stylesheets/page.less

@@ -517,6 +517,9 @@
         border-bottom: none;
       }
     }
+    .install-icon {
+      width: 75px;
+    }
   }
 
   .endpoint {

app/_data/docs_nav_studio_1.0.x.yml

@@ -0,0 +1,23 @@
+- title: Kong Studio
+  url: /index
+  items:
+    - text: Release Notes
+      url: /release-notes
+    - text: Changelog
+      url: /studio/changelog
+      absolute_url: true
+- title: Getting Started
+  url: /overview
+  items:
+    - text: Download & Install Kong Studio
+      url: /download-install
+    - text: Editing Spec Files
+      url: /editing-specs
+    - text: OpenAPI GraphQL Support
+      url: /graphql
+    - text: Debugging with Insomnia
+      url: /debugging-with-insomnia
+    - text: Git Sync with Studio
+      url: /git-sync
+    - text: Deploy to Dev Portal
+      url: /deploy-to-dev-portal

app/_data/kong_versions.yml

@@ -267,3 +267,7 @@
     postgres: "9.5+"
     openresty: "1.13.6.2"
   lua_doc: true
+-
+  release: "1.0.x"
+  version: "1.0"
+  edition: "studio"

app/_includes/footer.html

@@ -56,7 +56,7 @@ <h5>Products</h5>
           <ul>
             <li><a href="http://konghq.com/kong/">Kong</a></li>
             <li><a href="http://konghq.com/kong-enterprise/">Kong Enterprise</a></li>
-            <li><a href="http://konghq.com/cloud/">Kong Cloud</a></li>
+            <li><a href="http://konghq.com/kong-enterprise/studio/">Kong Studio</a></li>
             <li><a href="http://konghq.com/subscriptions/">Subscriptions</a></li>
           </ul>
         </nav>

app/_layouts/docs.html

@@ -14,17 +14,24 @@
       <nav class="docs-navigation">
         <a href="/" {% if page.edition=='community' %} class="active" {% endif %}>Kong</a>
         <a href="/enterprise" {% if page.edition=='enterprise' %} class="active" {% endif %}>Kong Enterprise</a>
+        <a href="/studio" {% if page.edition=='studio' %} class="active" {% endif %}>Kong Studio</a>
         <span class="sidebar-toggle">Open Sidebar</span>
       </nav>
       <div class="page-header-icon">
-        <img src="/assets/images/icons/icn-documentation{% if page.edition == 'enterprise' %}-ee{%else%}-ce{% endif %}.svg"
-          alt="Documentation" />
+          {% if page.edition == 'community' %}
+          <img src="/assets/images/icons/icn-documentation-ce.svg" alt="Documentation" />
+          {% endif %}
+          {% if page.edition == 'enterprise' %}
+          <img src="/assets/images/icons/icn-documentation-ee.svg" alt="Documentation" />
+          {% endif %}
+          {% if page.edition == 'studio' %}
+          <img src="/assets/images/icons/icn-documentation-studio.svg" alt="Documentation" />
+          {% endif %}
       </div>
       <div class="page-header-title">
         <h1>{{page.title}}</h1>
       </div>
 
-      {% if page.kong_versions.size > 1 %}
       <div class="versions-dropdown dropdown page-header-right {% if page.edition=='enterprise' %} page-header-right-enterprise {% endif %}">
         <button class="page-header-btn" id="version-dropdown" type="button" data-toggle="dropdown" aria-haspopup="true"
           aria-expanded="false">
@@ -47,7 +54,6 @@ <h1>{{page.title}}</h1>
           <input type="text" placeholder="Search" id="getkong-algolia-search-input" />
         </div>
       </div>
-      {% endif %}
     </div>
   </header>
 
@@ -56,9 +62,13 @@ <h1>{{page.title}}</h1>
       <span class="close-sidebar"></span>
       {% if page.edition == 'community' %}
       {% assign docs_url = '/' | append: page.kong_version %}
-      {% else %}
+      {% endif %}
+      {% if page.edition == 'enterprise' %}
       {% assign docs_url = '/' | append: 'enterprise/' | append: page.kong_version %}
       {% endif %}
+      {% if page.edition == 'studio' %}
+      {% assign docs_url = '/' | append: 'studio/' | append: page.kong_version %}
+      {% endif %}
 
       {% for nav in page.nav_items %}
       <nav>
@@ -188,3 +198,26 @@ <h2 id="table-of-contents">Table of Contents</h2>
 
 </script>
 {% endif %}
+
+{% if page.edition == 'enterprise' %}
+<script type="text/javascript">
+  docsearch({
+    appId: 'T5JKD83LWT',
+    apiKey: '1390283021f26e36117242934deb8d9d',
+    indexName: 'prod_Studio',
+    inputSelector: '#getkong-algolia-search-input',
+    algoliaOptions: {
+      hitsPerPage: 5,
+      'facetFilters': ["version: {{page.kong_version}}"]
+    },
+    // Override selected event to allow for local environment navigation
+    handleSelected: function (input, event, suggestion) {
+      input.setVal('');
+      window.location.href = window.location.protocol + "//" + window.location.host + suggestion.url.split(
+        "docs.konghq.com")[1]
+    }
+    // ,debug: true // Set debug to true if you want to inspect the dropdown
+  });
+
+</script>
+{% endif %}

app/_plugins/versions.rb

@@ -13,12 +13,18 @@ def generate(site)
         elem["edition"] && elem["edition"] == "enterprise"
       end
 
+      studioVersions = site.data["kong_versions"].select do |elem|
+        elem["edition"] && elem["edition"] == 'studio'
+      end
+
       site.data["kong_versions"] = ceVersions
       site.data["kong_versions_ee"] = eeVersions
+      site.data["kong_versions_studio"] = studioVersions
 
       # Retrieve the latest version and put it in `site.data.kong_latest.version`
       latestVersion = ceVersions.last
       latestVersionEE = eeVersions.last
+      latestVersionStudio = studioVersions.last
 
       site.data["kong_latest"] = latestVersion
 
@@ -28,14 +34,21 @@ def generate(site)
         parts = Pathname(page.path).each_filename.to_a
         page.data["has_version"] = true
         # Only apply those rules to documentation pages
-        if (parts[0] == "enterprise" || parts[0].match(/[0-3]\.[0-9]{1,2}(\..*)?$/))
+        if (parts[0] == "enterprise" || parts[0].match(/[0-3]\.[0-9]{1,2}(\..*)?$/) || parts[0] == 'studio')
           if(parts[0] == 'enterprise')
             page.data["edition"] = parts[0]
             page.data["kong_version"] = parts[1]
             page.data["kong_versions"] = eeVersions
             page.data["kong_latest"] = latestVersionEE
             page.data["nav_items"] = site.data['docs_nav_ee_' + parts[1].gsub(/\./, '')]
             createAliases(page, '/enterprise', 1, parts, latestVersionEE["release"])
+          elsif(parts[0] == 'studio')
+            page.data["edition"] = parts[0]
+            page.data["kong_version"] = parts[1]
+            page.data["kong_versions"] = studioVersions
+            page.data["kong_latest"] = latestVersionStudio
+            page.data["nav_items"] = site.data['docs_nav_studio_' + parts[1].gsub(/\./, '')]
+            createAliases(page, '/studio', 1, parts, latestVersionStudio["release"])
           else
             page.data["edition"] = "community"
             page.data["kong_version"] = parts[0]
@@ -45,6 +58,7 @@ def generate(site)
             createAliases(page, '', 0, parts, latestVersion["release"])
           end
 
+
           # Helpful boolean in templates. If version has .md, then it is not versioned
           if page.data["kong_version"].include? ".md"
             page.data["has_version"] = false

app/enterprise/0.36-x/deployment/installation/centos.md

@@ -64,6 +64,22 @@ To complete this guide you will need:
 
 ## Step 2. Install Kong Enterprise
 
+1. Verify the Kong Enterprise Signature
+
+    Kong's official Key ID is 2cac36c51d5f3726. Verify it by querying the package file:
+
+    ```
+    $ rpm -qpi kong-enterprise-edition-0.36.el7.noarch.rpm | grep Signature
+    ```
+    
+    Download Kong's official public key and ensure the integrity of the package:
+    
+    ```
+    $ curl -o kong.key https://bintray.com/user/downloadSubjectPublicKey?username=kong
+    $ rpm --import kong.key
+    $ rpm -K kong-enterprise-edition-0.36.el7.noarch.rpm
+    ```
+
 1. Install Kong Enterprise
 
     ```

app/studio/1.0.x/debugging-with-insomnia.md

@@ -0,0 +1,36 @@
+---
+title: Debugging Spec Files with Insomnia
+toc: false
+---
+
+### Introduction
+
+Kong Studio leverages the powerful open source debugging tool [Insomnia](https://insomnia.rest).
+Once you've designed your spec, you can generate requests and fully test and debug your spec right inside Kong Studio.
+
+
+## Debugging with Insomnia
+
+1. Open the **Workspace** of the spec you wish to test.
+
+2. In the upper right hand corner click **Test**
+
+![Test](https://doc-assets.konghq.com/studio/1.0/debugging/test.png)
+
+3. Kong Studio will prompt you to "Generate Requests", note that this will overwrite any existing test activity. Click **Generate Requests** to agree.
+
+![Generate Requests](https://doc-assets.konghq.com/studio/1.0/debugging/generate-requests.png)
+
+Kong Studio will generate the sample requests from the spec file and display them in the **Debug** view
+
+![Sample Requests](https://doc-assets.konghq.com/studio/1.0/debugging/sample-requests.png)
+
+4. Click on a request on the **Workspace sidebar** to populate that request into the **Request Panel**
+
+![Request Panel](https://doc-assets.konghq.com/studio/1.0/debugging/request-panel.png)
+
+5. Click **Send** to test the request. The response will render in the **Response Panel**
+
+![Response Panel](https://doc-assets.konghq.com/studio/1.0/debugging/response-panel.png)
+
+To lean more about generating requests and to full leverage the power of Insomnia, head over to [Insomnia's Documentation](https://support.insomnia.rest/)

app/studio/1.0.x/deploy-to-dev-portal.md

@@ -0,0 +1,50 @@
+---
+title: Deploy to the Dev Portal
+---
+
+### Introduction
+
+By connecting to your Kong Enterprise instance, Kong Studio can sync Spec files to
+and from your Dev Portal.
+
+
+### Prerequisites
+
+* Running Kong Enterprise 1.3 or later
+* Admin API privileges for the Workspace you will be connecting to
+* The Kong Developer Portal is enabled and running
+
+
+
+### Step 1. Connect to Kong Enterprise
+
+From Kong Studio:
+
+* Open the spec you want to deploy to the Developer Portal
+* Click on the **caret menu** and select **Deploy to Kong Portal**
+
+![Menu](https://doc-assets.konghq.com/studio/1.0/dev-portal/01-menu.png)
+
+
+Kong Studio will prompt you for information to connect to your **Kong Admin API**
+
+
+* Enter your API URL
+    * >Note: The URL here is the **ADMIN** **API** url set by the `admin_api_uri` property
+* Enter the Workspace for the Developer Portal you want to upload the spec  to
+* If your Admin API uses RBAC, enter the Token for to access the Workspace
+
+
+![Connect to Kong](https://doc-assets.konghq.com/studio/1.0/dev-portal/02-connect-to-kong.png)
+
+* Click **Connect to Kong** to validate Kong Studio’s connection. 
+
+
+### Step 2. Deploy a Spec file
+
+If successful, Kong Studio will then prompt you to specify a file name for the spec file - this will be the name of the file in the Developer Portal.
+
+![Deploy Spec](https://doc-assets.konghq.com/studio/1.0/dev-portal/03-deploy-spec.png)
+
+* Click **Upload to Kong Portal** to upload the spec file
+*  If there is an existing file with the same name Kong Studio will prompt you to overwrite the existing file or cancel

app/studio/1.0.x/download-install.md

@@ -0,0 +1,47 @@
+---
+title: Download and Install Kong Studio
+toc: false
+---
+
+
+## Download Kong Studio
+
+<div class="docs-grid">
+  <div class="docs-grid-block">
+    <h3>
+        <a href="https://bintray.com/kong/studio/desktop#files" target="_blank">Download for MacOS &rarr;</a>
+    </h3>
+  </div>
+    <div class="docs-grid-block">
+    <h3>
+        <a href="https://bintray.com/kong/studio/desktop#files"  target="_blank">Download for Windows &rarr;</a>
+    </h3>
+  </div>
+    <div class="docs-grid-block">
+    <h3>
+        <a href="https://bintray.com/kong/studio/desktop#files"  target="_blank">Download for Linux &rarr;</a>
+    </h3>
+  </div>
+</div>
+
+## Install Kong Studio
+
+### MacOS
+
+1. Download and open the `Kong-Studio.dmg` file
+
+2. Copy Kong Studio into the Application folder
+
+
+### Windows
+
+1. Download and open the `Kong-Studio.exe` file
+
+2. Follow the Kong Studio Setup and Installation Wizard
+
+
+### Linux
+
+1. Download and open the `Kong-Studio.AppImage` file
+
+2. Follow the Kong Studio Setup and Installation Wizard