v0.28

  - make confusing documentation less confusing.