Details
-
Bug
-
Resolution: Won't Fix
-
Minor
-
4.5
-
None
Description
From Roi Katz
I don’t like is the way new SDK information is organized.
If in the previous version I could navigate easily and see what are my options in terms of SDKs available, now I must use a dropdown which is located in the other end of the screen. It is very inconvenient.
Apart from the fact, that dropdown in a UI should be last resort:
- http://www.lukew.com/ff/entry.asp?1950
- https://medium.com/apegroup-texts/why-drop-down-lists-are-bad-for-the-user-experience-eeda5cbbd315#.fw0xj6wum
I would expect to see all of SDKs under “developers” right away.
From Perry Krug
Looking at this page: http://developer.couchbase.com/documentation/server/4.5/sdk/python/start-using-sdk.html
Readers coming in from the outside are typically going to Google for "getting started with php Couchbase". They're not going to find this page . However, these pages aren't so bad if you do land on this page. A few suggestions:
- Change "Start using the SDK" to "Getting Started with Couchbase SDKs"
- We need prominent pages that explicitly say "Getting Started with the PHP/Python/.NET/etc Couchbase SDK". They can either have a bit of content or just link directly to the right link of the above page, but our readers need to be able to see (and Google to index) that text explicitly
Going down into the "Working with Data", it's not clear to me for instance how to find an easy Java example of sub-doc manipulation: http://developer.couchbase.com/documentation/server/4.5/sdk/subdocument-operations.html. Similar to the above, the high-level description of these features is good, but we need the ability to search for and easily find the specifics for each language. Perhaps a drop-down is needed on these pages as well, but more importantly is the search-ability.