updated intro page for SGW #885
Conversation
This requires ui prod-213, and an asciidoc hack with empty section to close out the previous flex basis :sadpanda:
There was a problem hiding this comment.
This all looks technically correct to me from a developer perspective.
There are a few things I would rather not highlight on the starting page, such as Indexing vs Views. Is the intention to have a full TOC on the starting page, or just show common and useful information?
If the intention is to show useful information, I will have more comments. If the intention is to be a TOC of all the stuff in the sidebar, then some sections are missing. e.g. Deploy in the sidebar has more items than in the main page.
|
|
||
| You can read more about the Data Synchronization process in {sync-with-couchbase-server--xref}. | ||
| Some of its most central, and commonly used features, are those used to ensure secure **Access Control**. | ||
| * Role-Based Access Control. |
There was a problem hiding this comment.
I think this should be up to the PM and docs team, but it is weird to me that RBAC and RESTful API are in both sections Why Use Sync Gateway? and Key Capabilities
There was a problem hiding this comment.
The idea is to show common and useful information
| * xref:rest-api-access.adoc[] | ||
| * xref:rest-api-admin.adoc[] | ||
| * xref:rest-api-metrics.adoc[] |
There was a problem hiding this comment.
This is ultimately a question for docs team but since we switched from swagger to redocly, some of these pages are really just pass through to openapi and have actually no content
This definitely could be outside the scope of this review, I was just testing the links here.
If there's extra information on any of these pages. I find it annoying as a consumer of the docs to be sent to https://preview.docs-test.couchbase.com/docs-sync-gateway-DOC-13353-update-SGW-intro-page/sync-gateway/current/rest-api.html only to have to click through to https://preview.docs-test.couchbase.com/docs-sync-gateway-DOC-13353-update-SGW-intro-page/sync-gateway/current/rest_api_public.html
The same is true for admin and metrics.
Docs Issue: DOC-13353
Docs Preview: URL
You will need the Docs Team credentials on Confluence.