Vector.__mul__: Improve the docstring
Vector.__mul__: Improve the docstring

- Use the imperative form in the description.
- Simplify the examples showing the equivalence with dot and scale_by:
  use an assert rather than assume people notice the same value is produced.
- Add a reference to __truediv__

ppb/ppb-vector,ppb/ppb-vector