joyvuu-dave / comeals-rails

DEPRECATED Comeals allows cohousing communities to reconcile the cost of common meals.
1 stars 0 forks source link

As a user, I would like the app to be self-documenting. #17

Open crw opened 8 years ago

crw commented 8 years ago

Words like "Bill" (that is counted in cents, haha) and "Multiplier" are confusing to me, and I am a power user.

First, all terminology needs to be self-describing. For example,

Second, all options should have tooltips that explain their function. Ideally, clicking on form label text or form control in a mobile environment would cause the tooltips to be shown. Basically, it would be a standard for all form elements to have a description tag (data-desc?) that auto-generates the tooltip.

For example,

<label for="multiplier" data-desc="Children are billed for half the cost of an adult. Children are considered any human age 0-15.">
    Adult / Child?
</label>
<select id="multiplier" data-desc="Children are billed for half the cost of an adult. Children are considered any human age 0-15.">
    <option value="1">Child
    <option value="2" default>Adult
</select>

Something like that.