The text here in the taxes section is also technical and confusing. Not sure my version is "much" better, but I've attempted an explanation that should speak to the most common questions.

taxes

Taxes in Drupal Commerce have two parts: Tax Rates (percentages) and Tax Types (how & when they are applied). The Tax Rates page allows you to create as many kinds of percentage rates as you need. Each rate must be a kind of tax type, which comes in two defaults: Sales Tax (applied to total) or VAT (applied to product individually). You can control certain pricing actions by going to the Pricing Rules (link to admin/commerce/config/product-pricing) and changing their weights. By default, taxes are added to the order total (sales tax) or for each product's total (VAT).

CommentFileSizeAuthor
#1 Help on Taxes.png146.7 KBGuGuss
taxes.png95.41 KBjoshmiller
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

GuGuss’s picture

FileSize
146.7 KB

I would rather see a inline help text as we have for products and product types because it allows us to have more specific information and help for the user.

And then, we don't need to alter the current description on commerce_tax.

Help on Taxes.png

GuGuss’s picture

Assigned: Unassigned » dudenhofer

Here is a commit : https://code.drupalcommerce.org/#/c/415/

Still need a bit of theming to move the tab on top of the page (above the message and button).

Bojhan’s picture

Hmm, why keep the horribly confusing text? I don't think we should ever have two help texts.

joshmiller’s picture

Agreed with Bojhan and bojanz agrees as well. We should remove the current text (via CSS if necessary) and simply show the following (tweaked after some prodding from bojanz)...

Taxes are percentage-based rates (tax rates) that can get applied based on a various rules (tax types). Each tax rate is an implementation of a tax type. For example, you could create a 6% (tax rate) that is a value-added-tax (tax type, designed to be applied to products individually). If you need to change or control how the tax rates are applied, you can tweak the tax type rules, or create your own in the Pricing Rules (link to admin/commerce/config/product-pricing). By default, taxes are added to the order total (sales tax) or for each product's total (VAT).

^ The above has been polished and self-proofread...

vasike’s picture

Assigned: dudenhofer » vasike
Status: Active » Needs review

Rebased the previous commit with 2 changes within hook_preprocess_page in Commerce Kickstart inline help module.
1. Remove the system help. Replaced by inline help.
2. Moves the action links from pages with inline help, after inline help.
https://code.drupalcommerce.org/#/c/415/

bojanz’s picture

Status: Needs review » Fixed

Merged vasike's visual fixes with my own wording (since the text in #4 managed to confuse even me). We can tweak it more post-RC1.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.