Description
Hi,
I was talking to Maria about 2.1 futures and right now we have all of these field descriptions from Web Console in the Web Console chapter of documentation. Example here: http://www.couchbase.com/docs/couchbase-manual-2.0/couchbase-admin-web-console-data-buckets-individual.html#couchbase-admin-web-console-data-buckets-tapqueues
Where this information really belong is as tool tips in the UI itself. People are not going to go into the docs to find out what a field means. That is awkward and makes them leave the software. It is much easier to roll over the item and get context-sensitive information about the item in the UI.
I think having the amount of web console doc in documentation is a legacy of not having a UI designer/developer.
It is much easier and a standard industry practice to:
- only document how to manage something in a UI
- not document wizards since the process of how to use a wizard is already in the UI
- provide tool tips for UI elements (what it means, what it does) and make sure they are section 508 compliant.
If we can have this for 2.1, that would be great.
Thanks,
Karen